LINGTU AI OpenAPI
达人授权流程
带货发布、商品查询和橱窗管理都依赖 TikTok Shop 达人授权。本文只讲授权本身:在服务端获取授权链接,让达人打开或扫码授权,确认后必须回跳到回调页并提示「成功」,再查询可用账号;视频和图文发布流程都从这里开始。
授权流程图
每一步做什么
01
第 1 步 · 获取授权链接,开始授权
服务端按市场和店铺类型生成授权链接。
- oauthRegion 由市场和店铺类型组成,例如 us_local、us_cross、gb_local、id_cross
- 授权接口必须在服务端调用,x-api-key 不要下发到浏览器
- 返回的 url 直接打开,或转成二维码给达人
02
第 2 步 · 扫码授权 / 网页打开授权
达人扫码或在浏览器打开链接,进入 TikTok 授权页。
- 用手机扫二维码,或把 url 在浏览器打开
- 扫码和网页打开进入同一个 TikTok 授权页
- 同一个二维码只能用于一个账号,不要多人同时扫
无接口(人工步骤)
03
第 3 步 · 勾选权限
在 TikTok 授权页勾选需要的权限。
- 按发布场景勾选需要的授权权限
- 带货图文还需要图片发布权限,授权时一并勾选
- 缺少权限不等于 token 过期:先引导达人补授权
无接口(人工步骤)
04
第 4 步 · 点击确认授权
达人用后续要发布内容的 TikTok 账号确认。
- 必须用同一个具备带货权限、后续要发布内容的 TikTok 账号
- 账号本身就是 TikTok 账号,只是该账号具备带货权限
- 确认前核对账号,避免授权到错误的达人
无接口(人工步骤)
05
第 5 步 · 回跳 URL(必须跳转)
点击确认授权后必须回跳到回调 URL,不能停留在授权页。
- 点击确认授权后,页面必须自动回跳到回调 URL
- 回调链接示例:https://app.ailingtu.com/oauth/tiktokshop
- 回跳链接一定要用浏览器打开,或在 TikTok App 内打开
- 没有发生回跳、或回跳后打不开页面,都按授权失败处理
- 不要用内嵌 WebView,可能无法完成回跳
无接口(回调页)
06
第 6 步 · 显示授权成功
回跳后,回调页提示「成功」才算授权成功。
- 只看到达人端提示、没有回跳成功页,不算成功
- 回调页显示「成功」后再进入下一步
- 未显示成功按失败处理,重新生成授权链接再授权
无接口(回调页)
07
第 7 步 · 查询已授权达人
确认成功后查询账号,并保存 id 与 creatorId。
- 传 authSource=TIKTOK_SHOP_CREATOR 查询带货发布账号
- 用于带货图文时加 hasPhotoPermission=true
- 查商品用 id,创建发布任务用 creatorId,不要混用
08
第 8 步 · 管理授权
授权失效或权限不足时,按原因恢复。
- 授权失效时返回「授权过期,请重新授权」,账号会被置为失效
- 让达人用同一个 oauthRegion 重新授权,然后重新查询账号
- 达人不再需要发布时,解除授权
- 缺少权限不等于 token 过期:先引导达人补授权
关键分支
回跳并确认
点击确认授权后必须回跳,且回调页提示「成功」才算成功;没有回跳或未提示成功,都按失败处理。
一个二维码只用于一个账号
生成的二维码或授权链接只能完成一个账号授权;多个账号要分别生成。
授权失效
账号会被置为失效,接口返回「授权过期,请重新授权」;重新授权后要重新查询账号。
缺少图片权限
带货图文要求 permissions 包含 PHOTO_SHOPPABLE_PERMISSION_PRODUCT 或 PHOTO_SHOPPABLE_PERMISSION_SHOP;两者都没有则没有图片发布权限。
权限更新
达人权限发生变化时用 sync 更新权限,不会改变授权状态。
解除授权
达人不再发布时解除授权;之后再发布需要重新授权。
接入提示
- 授权链接按 oauthRegion 生成,市场与店铺类型要和被授权的 TikTok 账号一致。
- 被授权的是 TikTok 账号,只是该账号具备带货权限。
- 点击确认授权后必须回跳到回调 URL,并确认页面提示「成功」后再查询账号;没有回跳或未提示成功都算失败。
- 同一个二维码只能用于一个账号,不要让多个达人同时扫码。
- 链接必须在服务端生成,API 密钥不要出现在浏览器代码、二维码或日志里。
- 带货图文需要额外的图片权限,应在授权阶段确认,避免发布时才发现。
- 账号 id 与 creatorId 对应不同接口,查询账号后两个都要保存。