# 达人授权流程

TikTok Shop 达人授权的完整流程与标准接口：生成授权链接、达人授权与回调页确认、查询已授权达人，以及授权失效、权限不足和解除授权的处理。被授权的是具备带货权限的 TikTok 账号。

- 网页文档: [达人授权流程](/openapi/workflows/creator-authorization)
- Markdown: [Markdown](/openapi/workflows/creator-authorization.md)
- 接口索引: [接口索引](/openapi/operations/index.json)

## 发布流程图

```mermaid
flowchart TD
  A["获取授权链接，开始授权"] --> B["扫码授权 / 网页打开授权"]
  B --> C["勾选权限"]
  C --> D["点击确认授权"]
  D --> E["回跳 URL（必须跳转，用浏览器或 TikTok App 内打开）"]
  E --> F["显示授权成功"]
  E -. "失败：未回跳 / 未显示成功" .-> X["重新生成链接并重新授权"]
  F --> G["查询已授权达人"]
  G --> H["账号可用于发布"]
```

## 每一步做什么

1. 第 1 步 · 获取授权链接，开始授权：服务端按 oauthRegion 生成 url 或二维码；链接必须在服务端生成。
2. 第 2 步 · 扫码授权 / 网页打开授权：用手机扫码，或把 url 在浏览器打开。
3. 第 3 步 · 勾选权限：在 TikTok 授权页勾选需要的权限；带货图文还需要图片权限。
4. 第 4 步 · 点击确认授权：用同一个具备带货权限、后续要发布内容的 TikTok 账号确认。
5. 第 5 步 · 回跳 URL（必须跳转）：点击确认授权后页面必须自动回跳到回调 URL（示例：https://app.ailingtu.com/oauth/tiktokshop）；用浏览器打开或在 TikTok App 内打开，不要用内嵌 WebView。
6. 第 6 步 · 显示授权成功：回跳后，回调页提示「成功」才算成功；同一个二维码只能用于一个账号。
7. 第 7 步 · 查询已授权达人：成功后传 authSource=TIKTOK_SHOP_CREATOR；图文加 hasPhotoPermission=true；保存 id 与 creatorId。
8. 第 8 步 · 管理授权：授权失效返回「授权过期，请重新授权」并置账号失效；缺权限先引导补授权。

## 关键分支

- **回跳并确认**：点击确认授权后必须回跳，且回调页提示「成功」才算成功；没有回跳或未提示成功都按失败处理。
- **一个二维码只用于一个账号**：二维码或授权链接只能完成一个账号授权；多个账号要分别生成。
- **授权失效**：账号被置为失效；重新授权后重新查询账号。
- **缺少图片权限**：带货图文需要图片发布权限，用 hasPhotoPermission=true 确认。
- **权限更新**：达人权限发生变化时用 sync 更新权限，不改变授权状态。
- **解除授权**：达人不再发布时解除授权。

## 接口顺序

| 步骤 | 接口 |
|---|---|
| 1 | [GET /v1/creatorAccount/tiktokShopOauth/authorize](/openapi/authorize-creator) |
| 2–6 | 无接口（扫码、勾选权限、确认、回跳链接、授权成功） |
| 7 | [GET /v1/creatorAccount/pageList](/openapi/creators) |
| 8 | [GET /v1/creatorAccount/tiktokShopOauth/authorize](/openapi/authorize-creator) · [POST /v1/creatorAccount/revoke](/openapi/revoke-creator) |

## 接入提示

- 授权链接按 oauthRegion 生成，市场与店铺类型要和被授权的 TikTok 账号一致。
- 被授权的是 TikTok 账号，只是该账号具备带货权限。
- 点击确认授权后必须回跳到回调 URL，并确认页面提示「成功」后再查询账号；没有回跳或未提示成功都算失败。
- 同一个二维码只能用于一个账号，不要让多个达人同时扫码。
- 链接必须在服务端生成，密钥不要出现在浏览器代码、二维码或日志里。
- 带货图文需要额外的图片权限，应在授权阶段确认。
- 查询账号后同时保存账号 id 与 creatorId。
- sync 只用于更新达人权限，不用于修改昵称或头像。
