您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。

LINGTU AI OpenAPI

带货图文发布流程

本文只覆盖 TikTok Shop 带货图文。前置条件是达人已完成 TikTok Shop 授权并具备图片发布权限;之后按「选择达人 → 选品与排期 → 上传图片与设置 → 校验并创建任务 → 发布记录」执行。图文没有预审。

前置条件:先完成 达人授权流程

发布流程图

是否立即定时
前置:已完成授权
已授权且具备图片发布权限;authSource=TIKTOK_SHOP_CREATOR + hasPhotoPermission=true
选择达人
选择具备图片权限的已授权达人;发布任务用 creatorId
选择商品
店铺商品 / 橱窗商品,按商品 ID 或链接选品
设置排期
发布时区、发布日期、每天条数,或立即发布
前端设置,无需接口
上传图片
1~15 张有序图片,顺序即展示顺序
带货设置
商品标题、音乐、AI 标识;无封面、无预审
第 5 步:校验
无预审;标题、图片、商品、时间(≥5 分钟)
前端校验,无需接口
创建发布任务
立即:scheduledAt=当前时间;定时:排期时间 + scheduledTz
发布记录
状态、平台作品 ID、失败原因;待发布可 submit / update / cancel
秒传复用文件
复用已存在图片的 fileId,跳过 PUT 和 confirm
预签名 isNew?定时发布?
TikTok Shop 带货图文发布流程图:选择已授权达人、选品与排期、上传素材、带货设置、校验、创建发布任务与发布记录。

每一步做什么

01

第 1 步 · 选择达人

选择具备图片发布权限的已授权达人账号。

  • 查询账号时传 hasPhotoPermission=true,并确认 permissions 包含 PHOTO_SHOPPABLE_PERMISSION_PRODUCT 或 PHOTO_SHOPPABLE_PERMISSION_SHOP;两者都没有则没有带货图文权限
  • 创建发布任务用 creatorId,查询商品用账号 id
02

第 2 步 · 选品与排期

选择店铺或橱窗商品,设置发布日期。

  • 商品来自店铺或橱窗;橱窗缺商品时可按商品 ID 或链接添加
  • 设置发布时区、发布日期、每天条数,或选择立即发布
  • 发布前确认商品有库存,否则平台可能丢弃商品锚点(掉车)
03

第 3 步 · 上传图片

按展示顺序上传 1~15 张图片,走预签名直传。

  • 每张图片分别走预签名;isNew=true 时 PUT,然后 confirm
  • 保持上传顺序,它就是最终展示顺序
  • 一个任务支持 1~15 张图片
  • createPost 的 businessIds 用字符串文件 ID,按展示顺序排列
04

第 4 步 · 带货设置

设置每个图文任务的商品标题、音乐和 AI 生成标识。

  • 商品标题必填、可修改;发布前校验禁用字符和长度
  • 音乐可搜索或复用灵途音乐收藏,发布以 musicId 为准
  • 图文没有封面设置,也没有视频预审
  • 需要时标记为 AI 生成内容
05

第 5 步 · 校验并创建任务

校验图片、商品与排期后创建发布任务。

  • 校验 1~15 张图片、商品、标题和排期时间(至少提前 5 分钟)
  • 图文完全跳过预审
  • 调用 createPost,mediaType=PHOTO,tiktokShopPhoto.postType=MULTI_PHOTO_ONE_ANCHOR
  • businessIds 与 productLinks 分别描述图片和商品锚点
06

发布后 · 记录与跟进

跟踪平台作品 ID 和失败原因。

  • 创建成功只表示任务已接收
  • 查询发布记录与任务详情获取最终状态
  • 对待发布任务立即发布,修改仍可变更的任务,或取消任务
  • 保存 postId 便于后续跟进

关键分支

必须有图片权限

permissions 必须包含 PHOTO_SHOPPABLE_PERMISSION_PRODUCT 或 PHOTO_SHOPPABLE_PERMISSION_SHOP;两者都没有则没有带货图文权限。

1~15 张图片,顺序重要

businessIds 按展示顺序排列;要调整顺序应在创建任务前完成,发布后无法改。

没有预审

带货图文没有预审;校验发生在 createPost 之前,平台失败原因在发布记录中查看。

定时 / 立即发布

定时任务至少提前 5 分钟;立即发布把 scheduledAt 设为当前时间。

创建成功 ≠ 发布成功

createPost 只表示任务已接收;最终平台状态以发布记录为准。

接入提示

  • 授权成功不等于能发图文:带货图文还需要图片发布权限。
  • 图片顺序要稳定;businessIds 就是展示顺序,发布后不能再调整。
  • businessIds 传字符串文件 ID,不要传数字。
  • scheduledAt 是绝对时间戳,scheduledTz 是目标市场的 IANA 时区。
  • isNew=false 表示图片已存在,直接复用 fileId,不要重复上传。