# 带货发布总览

带货发布只覆盖 TikTok Shop 带货视频与带货图文。两条流程共用授权、选品、排期、创建任务和发布记录；差异集中在素材与带货设置。

- 网页文档: [带货发布总览](/openapi/workflows/commerce-publishing)
- Markdown: [Markdown](/openapi/workflows/commerce-publishing.md)
- 接口索引: [接口索引](/openapi/operations/index.json)

## 发布流程图

```mermaid
flowchart TD
  A["达人授权"] --> B["选品与排期"]
  B --> C["素材与带货设置"]
  C --> D["校验与创建任务"]
  D --> E["发布记录"]
  C -. "视频" .-> V["带货视频细节"]
  C -. "图文" .-> P["带货图文细节"]
```

## 每一步做什么

1. 第 1 步 · 达人授权：生成授权链接，达人确认，用 authSource=TIKTOK_SHOP_CREATOR 查询账号。
2. 第 2 步 · 选品与排期：选择店铺或橱窗商品，设置发布日期或立即发布。
3. 第 3 步 · 素材与设置：视频 1 条文件、可选预审和封面；图文 1～15 张有序图片且需要图片权限。
4. 第 4 步 · 校验与创建：逐条调用 createPost，传 scheduledAt 与 scheduledTz。
5. 发布后：查询记录获取状态、作品 ID 和失败原因。

## 关键分支

- **视频**：1 条视频、可选预审、封面截帧或上传。
- **图文**：1～15 张有序图片、图片权限、无预审和封面。
- **创建成功 ≠ 发布成功**：最终状态以发布记录为准。
- **定时 / 立即发布**：定时至少提前 5 分钟。

## 接口顺序

| 步骤 | 接口 |
|---|---|
| 1 | [GET /v1/creatorAccount/tiktokShopOauth/authorize](/openapi/authorize-creator) · [GET /v1/creatorAccount/pageList](/openapi/creators) |
| 2 | [GET /v1/creator/tiktokshop/product/listByShop](/openapi/shop-products) · [GET /v1/creator/tiktokshop/product/listByShowcase](/openapi/showcase-products) |
| 3 | [POST /v1/file/presign](/openapi/presign) · `PUT presigned URL` · [POST /v1/file/confirm](/openapi/confirm) |
| 4 | [POST /v1/creator/post/create](/openapi/create-post) |
| 5 | [GET /v1/creator/post/pageList](/openapi/post-records) · [POST /v1/creator/post/submit](/openapi/submit-post) · [POST /v1/creator/post/update](/openapi/update-post) · [POST /v1/creator/post/cancel](/openapi/cancel-post) |

## 接入提示

- 细节页面：达人授权、带货视频、带货图文。
- 带货发布只接受 TikTok Shop 授权达人；图文还需要图片权限。
- 查商品用账号 id，创建任务用 creatorId。
- 发布前确认商品有库存。
