发布流程
https://api.ailingtu.com
01
授权达人
oauthRegion → url02
查询达人
id + creatorId03
选择商品
SHOP / SHOWCASE04
上传素材
presign → PUT → confirm05
创建发布任务
VIDEO / PHOTO鉴权方式
x-api-key: <YOUR_API_KEY>
API Key 仅保存在服务端,不要暴露在浏览器代码、排期表或日志中。
成功判断
HTTP 2xx && response.code === 0
HTTP 非 2xx、响应不是合法 JSON 或业务 code 非 0,均应按失败处理。
机器可读接口规范
AI Agent、SDK 生成和契约校验应优先读取 OpenAPI 规范。
联调检查清单
区分商品查询 id 与发布 creatorId
isNew=false 时跳过 PUT 和 confirm
photoUri 传 tiktokShop.coverUri,coverFileId 放请求根节点
图文 businessIds 严格保持展示顺序
保存 postId 并确认最终发布状态
准备开始接入?
在灵途 AI 开发者中心创建或管理 API Key。