# 同步账号资料

- API 版本：1.10.0
- 最后更新：2026-09-29
- 服务地址：`https://api.ailingtu.com`
- 网页文档：[同步账号资料](/openapi/sync-creator)
- 完整接口约束：[JSON Schema](/openapi/operations/syncCreatorAccount.json)
- 接口发现：[接口索引](/openapi/operations/index.json)

## POST /v1/creatorAccount/sync

接口标识：`syncCreatorAccount`

同步账号资料。

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

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

### 请求参数

| 字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| `id` | body | integer | 是 | 单个账号 |

请求格式：`application/json`

### 请求示例

```json
{
  "id": 12345
}
```

### 成功响应

```json
{
  "code": 0,
  "message": "success",
  "data": null,
  "timestamp": 1790640000000
}
```

### 响应字段

以下列出主要层级；完整结构、联合类型及校验规则以接口 JSON Schema 为准。必填指字段所在对象中的约束。

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `code` | integer | 是 | — |
| `message` | string | 是 | — |
| `data` | null | 是 | — |
| `timestamp` | integer | 是 | — |

### 接入说明与限制

- 按账号的授权来源重新拉取 TikTok 账号资料并更新本地记录：

- `TIKTOK_LOGIN_KIT`：走 TikTok for Developers 的用户信息接口，更新用户名、头像、union_id 和授权范围
- `TIKTOK_BUSINESS_ACCOUNT_API`：走 `/business/get/`，更新用户名、昵称、头像、粉丝数等资料
- `TIKTOK_SHOP_CREATOR`：走 TikTok Shop 创作者资料接口

授权来源为空或不属于以上三种时直接报错，不做任何同步。只刷新资料，不改变账号的授权状态，也不会触发重新授权。