开发者文档 / 带货内容发布
同步账号资料
POST
/v1/creatorAccount/sync- 鉴权：
- 请求头 x-api-key: <YOUR_API_KEY>；密钥仅保存在服务端。
- 成功判断：
- HTTP 2xx 且响应 code=0；异步任务还需查询最终状态。
请求字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | integer | 是 | 单个账号 |
按账号的授权来源重新拉取 TikTok 账号资料并更新本地记录：
- `TIKTOK_LOGIN_KIT`：走 TikTok for Developers 的用户信息接口，更新用户名、头像、union_id 和授权范围
- `TIKTOK_BUSINESS_ACCOUNT_API`：走 `/business/get/`，更新用户名、昵称、头像、粉丝数等资料
- `TIKTOK_SHOP_CREATOR`：走 TikTok Shop 创作者资料接口
授权来源为空或不属于以上三种时直接报错，不做任何同步。只刷新资料，不改变账号的授权状态，也不会触发重新授权。
请求体
{
"id": 12345
}成功响应
{
"code": 0,
"message": "success",
"data": null,
"timestamp": 1790640000000
}响应与错误
主要响应字段来自接口规范；完整层级、联合类型和校验规则见 JSON Schema。必填指字段所在对象中的约束。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | integer | 是 | — |
message | string | 是 | — |
data | null | 是 | — |
timestamp | integer | 是 | — |
参数、权限或授权错误需先修正。创建发布或生成任务超时后先查询已有任务，避免重复创建；不要因轮询中断而重复提交。
最后更新 · 2026-09-29