开发者文档 / 商品与橱窗
创作者TTS-置顶橱窗商品
把已在创作者 TikTok Shop 橱窗中的商品移动到顶部,多个商品按数组顺序排列。
POST
/v1/creator/tiktokshop/product/moveToTopInShowcase- 鉴权:
- 请求头 x-api-key: <YOUR_API_KEY>;密钥仅保存在服务端。
- 成功判断:
- HTTP 2xx 且响应 code=0;异步任务还需查询最终状态。
请求字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | integer | 是 | 创作者账号 ID(creator account id) |
productIds | string[] | 是 | 已经在橱窗中的商品 ID 列表,按数组顺序置顶 |
所需 scope:creator.showcase.write。
productIds 必须已在橱窗中;多个商品按数组顺序置顶,数组第一个排在最前。
成功时 data 为 null,没有逐项结果。
平台返回 16015001 时转成业务错误「商品已不在橱窗中,请刷新列表后重试」,可刷新橱窗列表后重试。
平台返回 16015027 系统错误时错误码原样返回,可重试。
创作者授权失效时返回「授权过期,请重新授权」,同时把该达人账号置为失效;缺少权限时返回权限不足,不会把账号置为失效。
请求体
{
"id": 12345,
"productIds": [
"12390753231",
"7102893481290"
]
}成功响应
{
"code": 0,
"message": "success",
"data": null,
"timestamp": 1790640000000
}响应与错误
主要响应字段来自接口规范;完整层级、联合类型和校验规则见 JSON Schema。必填指字段所在对象中的约束。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | integer | 是 | 业务状态码,0 表示成功。 |
message | string | 是 | — |
data | null | 是 | 本接口无业务数据返回。 |
timestamp | integer | 是 | Unix 时间戳,单位毫秒。 |
HTTP 400请求参数或请求体无效,请修正后重试。HTTP 401API 密钥缺失或无效,请检查 x-api-key。HTTP 403API 密钥没有此接口的调用权限。HTTP 429请求过于频繁,请采用指数退避重试。HTTP 500服务端发生错误;对于暂时性故障采用指数退避重试。
参数、权限或授权错误需先修正。创建发布或生成任务超时后先查询已有任务,避免重复创建;不要因轮询中断而重复提交。
最后更新 · 2026-11-16