您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。

LINGTU AI OpenAPI

达人授权流程

带货发布、商品查询和橱窗管理都依赖 TikTok Shop 达人授权。本文只讲授权本身:在服务端获取授权链接,让达人打开或扫码授权,确认后必须回跳到回调页并提示「成功」,再查询可用账号;视频和图文发布流程都从这里开始。

授权流程图

失败
获取授权链接,开始授权
服务端按 oauthRegion 生成 url 或二维码
扫码授权 / 网页打开授权
用手机扫二维码,或把 url 在浏览器打开
无接口(人工步骤)
勾选权限
在 TikTok 授权页勾选需要的权限;带货图文还需要图片权限
无接口(人工步骤)
点击确认授权
用具备带货权限、后续要发布内容的 TikTok 账号确认
无接口(人工步骤)
回跳 URL(必须跳转)
点击确认授权后必须回跳到回调 URL;用浏览器打开或在 TikTok App 内打开
回调页:https://app.ailingtu.com/oauth/tiktokshop
显示授权成功
回调页提示「成功」才算授权成功
先确认结果
查询已授权达人
authSource=TIKTOK_SHOP_CREATOR;带货图文加 hasPhotoPermission=true
账号可用
查商品用账号 id,创建发布任务用 creatorId
进入带货视频或图文流程
失败:未回跳 / 未显示授权成功
确认授权后必须回跳到回调 URL。若停留在授权页,检查是否用浏览器或 TikTok App 打开;同一个二维码只能用于一个账号,失败后重新生成链接再授权。
TikTok Shop 达人授权流程图:获取授权链接,扫码或网页打开授权,勾选权限,点击确认授权,用浏览器或 TikTok App 打开回跳链接,显示授权成功后查询已授权达人。

回调链接示例: https://app.ailingtu.com/oauth/tiktokshop

每一步做什么

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 对应不同接口,查询账号后两个都要保存。