后台操作指南（无技术能力用户）

不需要写代码。整条路径：登录后台 → 绑定账号 → 上传视频 → 复制参数 → 用 API Playground 发起发布。

1. 登录

打开 https://cli.haina.io，用管理员给你的邮箱+密码登录（首次登录后建议在「设置」里改密码）。

2. 绑定账号（坐席）

左侧「坐席」→ 空槽点「绑定」：

• 在 TikTok 上发普通视频 → 选 TikTok
• 发 TikTok Shop 挂车视频（携带商品锚点）→ 选 TikTok Shop

注意，需要选择对应TikTok Shop正确的店铺类型（美区本土店/美区跨境店/欧区本土店/创作者橱窗)

用手机扫码完成授权（或点「复制链接」发给已登录该账号的浏览器打开）。授权成功后坐席显示账号信息。

同一个 TikTok 账号的两种能力绑在同一个坐席上（只占 1 个坐席）。授权链接 10 分钟有效。

授权到坐席后，会显示出对应的账号ID（后续标识需要发布视频的目标账号）

3. 上传视频（视频库）

发布前先把视频传进视频库，拿到发布所需的"钥匙"：发 TikTok 普通视频用视频 URL（7 天有效），发 TikTok Shop 挂车视频用 fileId（一次性消耗）。

左侧「视频库」：

• 发到 TikTok 主页 → 在「TikTok 发布」tab 点「上传视频」
• 发到 TikTok Shop → 在「TikTok Shop 挂车」tab 点「上传视频」，选择已绑定的 TikTok Shop 账号

上传完成后，卡片上有：

• 预览（TikTok 视频可直接播放检查）
• 复制链接（TikTok 视频的视频 URL）
• 复制 fileId（TikTok Shop 视频）
• 有效期提示（TikTok 视频 7 天有效）/ 发布状态（TTS）

4. 选商品（TikTok Shop 挂车需要）

左侧「商品库」→ 选择 TikTok Shop 账号 → 浏览店铺/橱窗商品 → 点商品卡片的复制按钮拿到商品 ID。

商品数据是 TikTok Shop 实时拉取的短缓存副本，可能不是最新；点「刷新」穿透缓存直取。

5. 素材工具（封面/背景音乐，可选）

左侧「素材工具」：选择 TikTok Shop 账号后——

• 封面上传：选图上传 → 得 photoUri（发布时作 coverUri）
• 背景音乐搜索：关键词搜索 → 试听 → 复制音乐 ID（发布时作 musicId）

6. 发布（用 API Playground，免装 Postman）

打开「文档 → API Playground」（/docs/api），右侧认证处粘贴你的裸 API Key（不要自己加 Bearer 前缀，详见认证与约定），找到对应端点点「Try it」直接调：

• TikTok 发布：POST /v1/tiktok/v1.3/business/video/publish
• TikTok Shop 预审（可选，建议做）：POST /v1/publish/tts/precheck
• TikTok Shop 预审结果：GET /v1/publish/tts/precheck/{taskId}
• TikTok Shop 挂车发布：POST /v1/publish/tts

Body（TT）：

{
  "videoUrl": "<视频库卡片上的视频 URL（上传响应的 videoUrl）>",
  "account": "<坐席页 TikTok 行的账号 ID 或用户名>",
  "caption": "文案 #话题"
}

Body（TikTok Shop 预审）：

{
  "fileId": "<上传 TikTok Shop 视频响应的 fileId>",
  "accountId": "<坐席页 TikTok Shop 行的账号 ID>",
  "productId": "<商品库复制的商品 ID>",
  "productTitle": "车用脚垫"
}

Body（TikTok Shop 发布）：

{
  "fileId": "<上传 TikTok Shop 视频响应的 fileId>",
  "accountId": "<坐席页 TikTok Shop 行的账号 ID>",
  "productId": "<商品库复制的商品 ID>",
  "title": "文案 #话题",
  "productTitle": "车用脚垫",
  "coverUri": "<可选：素材工具页上传封面所得 photoUri>",
  "musicId": "<可选：素材工具页搜索复制的音乐 ID>"
}

⚠️ 发布入参全部用官方返回的 id（fileId/accountId/productId），不需要预审凭证；但官方规则要求违规内容不应发布，建议先预审（failed 就不要发）。fileId 一次性消耗，失败也要换视频重来。

7. 发布记录

左侧「发布记录」：每条发布的时间/能力/视频/账号/商品/状态/消息。进行中的记录每 10 秒自动刷新到终态（无需手点）；TikTok 成功的记录可点「数据」看播放/点赞等官方指标。