# 获取 TikTok Shop 授权地址

- API 版本：1.10.0
- 最后更新：2026-09-29
- 服务地址：`https://api.ailingtu.com`
- 网页文档：[获取 TikTok Shop 授权地址](/openapi/authorize-creator)
- 完整接口约束：[JSON Schema](/openapi/operations/createTikTokShopAuthorizationUrl.json)
- 接口发现：[接口索引](/openapi/operations/index.json)

## GET /v1/creatorAccount/tiktokShopOauth/authorize

接口标识：`createTikTokShopAuthorizationUrl`

按目标市场和店铺类型生成 TikTok Shop 达人授权地址。将响应中的 url 在浏览器打开或生成二维码，引导达人完成授权。

鉴权：请求头 `x-api-key: <YOUR_API_KEY>`；密钥仅保存在服务端。

成功判断：HTTP 2xx 且响应 code=0；异步任务还需查询最终状态。

### 请求参数

| 字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| `oauthRegion` | query | 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 表示跨境店 |

### 成功响应

```json
{
  "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 | 否 | 响应时间戳，单位毫秒。 |

### 接入说明与限制

- 美国跨境店传 us_cross，美国本土店/ACCU 店传 us_local。
- 英国跨境授权已下线，仅支持 gb_local。
- 授权地址应由服务端使用密钥获取；不要将密钥暴露在浏览器代码中。

### 错误处理

| HTTP | 说明 |
|---|---|
| 400 | 请求参数或请求体无效，请修正后重试。 |
| 401 | API 密钥缺失或无效，请检查 x-api-key。 |
| 403 | API 密钥没有此接口的调用权限。 |
| 429 | 请求过于频繁，请采用指数退避重试。 |
| 500 | 服务端发生错误；对于暂时性故障采用指数退避重试。 |

业务 code 非零时也应按失败处理。不要对参数、权限或授权错误盲目重试。创建发布或生成任务超时后先查询原任务，避免重复创建。