开发者文档 / 带货内容发布
获取 TikTok Shop 授权地址
按目标市场和店铺类型生成 TikTok Shop 达人授权地址。将响应中的 url 在浏览器打开或生成二维码，引导达人完成授权。
GET
/v1/creatorAccount/tiktokShopOauth/authorize- 鉴权：
- 请求头 x-api-key: <YOUR_API_KEY>；密钥仅保存在服务端。
- 成功判断：
- HTTP 2xx 且响应 code=0；异步任务还需查询最终状态。
Query 参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
oauthRegion | us_cross | us_local | br_local | br_cross | mx_local | mx_cross | gb_local | de_local | de_cross | fr_local | fr_cross | es_local | es_cross | it_local | it_cross | ie_local | ie_cross | jp_local | jp_cross | th_local | th_cross | my_local | my_cross | id_local | id_cross | sg_local | sg_cross | vn_local | vn_cross | ph_local | ph_cross | 是 | 授权地区与店铺类型；_local 表示本土店，_cross 表示跨境店 |
美国跨境店传 us_cross，美国本土店/ACCU 店传 us_local。
英国跨境授权已下线，仅支持 gb_local。
授权地址应由服务端使用密钥获取；不要将密钥暴露在浏览器代码中。
成功响应
{
"code": 0,
"data": {
"url": "https://services.tiktokshop.com/open/authorize?service_id=example&state=example"
},
"message": "success"
}响应与错误
主要响应字段来自接口规范；完整层级、联合类型和校验规则见 JSON Schema。必填指字段所在对象中的约束。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | integer | 是 | 固定值：0 |
message | string | 否 | — |
data | object | 是 | — |
data.url | string | 是 | TikTok Shop OAuth 授权链接。 |
timestamp | integer | 否 | 响应时间戳，单位毫秒。 |
HTTP 400请求参数或请求体无效，请修正后重试。HTTP 401API 密钥缺失或无效，请检查 x-api-key。HTTP 403API 密钥没有此接口的调用权限。HTTP 429请求过于频繁，请采用指数退避重试。HTTP 500服务端发生错误；对于暂时性故障采用指数退避重试。
参数、权限或授权错误需先修正。创建发布或生成任务超时后先查询已有任务，避免重复创建；不要因轮询中断而重复提交。
最后更新 · 2026-09-29