开发者文档 / 带货内容发布
获取 TikTok 发布配置
GET
/v1/creatorAccount/tiktok/publishConfig- 鉴权：
- 请求头 x-api-key: <YOUR_API_KEY>；密钥仅保存在服务端。
- 成功判断：
- HTTP 2xx 且响应 code=0；异步任务还需查询最终状态。
Query 参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | integer | 是 | ID 编号 |
按账号的授权来源返回发布设置，前端只用一份响应结构：
- `TIKTOK_LOGIN_KIT`（TikTok for Developers）：查 Creator Info，返回账号昵称、头像、隐私级别选项、三个互动限制和最大发布时长
- `TIKTOK_BUSINESS_ACCOUNT_API`（TikTok API for Business）：查 `/business/video/settings/`，返回隐私级别选项、三个互动限制和最大发布时长；`creatorUsername`、`creatorNickname`、`creatorAvatarUrl` 固定为 `null`（Business 侧没有这三个字段）
- `TIKTOK_SHOP_CREATOR`（TikTok Shop 达人）：不支持 TikTok 内容直发，直接报错
注意：TikTok Business 视频不传 privacyLevel；Business 图文的 privacyLevel 必须取自返回的选项。
成功响应
{
"code": 0,
"message": "success",
"data": {
"creatorUsername": null,
"creatorNickname": null,
"creatorAvatarUrl": null,
"privacyLevelOptions": [
"SELF_ONLY"
],
"commentDisabled": false,
"duetDisabled": true,
"stitchDisabled": true,
"maxVideoPostDurationSec": 3600
},
"timestamp": 1790640000000
}响应与错误
主要响应字段来自接口规范；完整层级、联合类型和校验规则见 JSON Schema。必填指字段所在对象中的约束。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | integer | 是 | — |
message | string | 是 | — |
data | object | 是 | — |
data.creatorUsername | string | null | 是 | — |
data.creatorNickname | string | null | 是 | — |
data.creatorAvatarUrl | string | null | 是 | — |
data.privacyLevelOptions | string[] | 是 | — |
data.commentDisabled | boolean | 是 | — |
data.duetDisabled | boolean | 是 | — |
data.stitchDisabled | boolean | 是 | — |
data.maxVideoPostDurationSec | integer | 是 | — |
timestamp | integer | 是 | — |
参数、权限或授权错误需先修正。创建发布或生成任务超时后先查询已有任务，避免重复创建；不要因轮询中断而重复提交。
最后更新 · 2026-09-29