# 带货图文发布流程

TikTok Shop 带货图文发布流程与标准接口：选择达人（需图片权限）、选品与排期、1～15 张图片上传、商品标题与音乐设置、创建发布任务与发布记录。图文没有预审。

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

## 发布流程图

```mermaid
flowchart TD
  A["已授权且具备图片权限的达人"] --> B["选择达人"]
  B --> C["选品与排期"]
  C --> D["上传 1～15 张有序图片"]
  D --> E{"预签名 isNew?"}
  E -- "是" --> F["PUT + confirm"]
  E -- "否" --> G["复用 fileId"]
  F --> H["带货设置：标题、音乐、AI 标识"]
  G --> H
  H --> I["校验；无预审"]
  I --> J{"定时发布?"}
  J -- "立即" --> K["createPost scheduledAt=当前时间"]
  J -- "定时" --> L["createPost 排期时间 + scheduledTz"]
  K --> M["发布记录"]
  L --> M
```

## 每一步做什么

1. 第 1 步 · 选择达人：用 hasPhotoPermission=true 查询账号，并确认 permissions 包含 PHOTO_SHOPPABLE_PERMISSION_PRODUCT 或 PHOTO_SHOPPABLE_PERMISSION_SHOP；创建任务用 creatorId，查商品用账号 id。
2. 第 2 步 · 选品与排期：选择店铺或橱窗商品，设置发布日期或立即发布。
3. 第 3 步 · 上传图片：1～15 张，每张走 presign → PUT → confirm，并保持展示顺序。
4. 第 4 步 · 带货设置：商品标题、音乐和 AI 标识；没有封面，也没有视频预审。
5. 第 5 步 · 校验与创建：检查图片数量/顺序、商品、标题和排期（至少提前 5 分钟）；createPost 传 mediaType=PHOTO 与 postType=MULTI_PHOTO_ONE_ANCHOR。
6. 发布后：查询记录获取平台作品 ID 和失败原因；按需立即发布、修改或取消。

## 关键分支

- **必须有图片权限**：permissions 必须包含 PHOTO_SHOPPABLE_PERMISSION_PRODUCT 或 PHOTO_SHOPPABLE_PERMISSION_SHOP；两者都没有则没有带货图文权限。
- **1～15 张图片，顺序重要**：businessIds 按展示顺序，发布后不能调整。
- **没有预审**：校验发生在 createPost 之前，平台失败原因在发布记录中查看。
- **定时 / 立即发布**：定时至少提前 5 分钟。
- **创建成功 ≠ 发布成功**：最终状态以发布记录为准。

## 接口顺序

| 步骤 | 接口 |
|---|---|
| 1 | [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 | [GET /v1/creator/tiktokshop/searchMusic](/openapi/search-music) |
| 5 | [POST /v1/creator/post/create](/openapi/create-post) |
| 6 | [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) |

## 接入提示

- 授权成功不等于能发图文：permissions 需包含 PHOTO_SHOPPABLE_PERMISSION_PRODUCT 或 PHOTO_SHOPPABLE_PERMISSION_SHOP。
- 图片顺序要稳定；businessIds 就是展示顺序。
- businessIds 传字符串文件 ID，不要传数字。
- scheduledAt 是绝对时间戳，scheduledTz 是 IANA 时区。
