# 获取 TikTok 发布配置

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

## GET /v1/creatorAccount/tiktok/publishConfig

接口标识：`getTikTokPublishConfig`

获取 TikTok 发布配置。

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

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

### 请求参数

| 字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| `id` | query | integer | 是 | ID 编号 |

### 成功响应

```json
{
  "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 | 是 | — |

### 接入说明与限制

- 按账号的授权来源返回发布设置，前端只用一份响应结构：

- `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 必须取自返回的选项。

### 相关接口

- [创建发布任务](/openapi/create-post) · [Markdown](/openapi/operations/createCreatorPost.md)