您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。
创作者TTS-移除橱窗商品
开发者文档 / 商品与橱窗

创作者TTS-移除橱窗商品

把商品从创作者 TikTok Shop 展示橱窗中移除,一次可传 1~200 个商品 ID。

POST/v1/creator/tiktokshop/product/removeFromShowcase
鉴权:
请求头 x-api-key: <YOUR_API_KEY>;密钥仅保存在服务端。
成功判断:
HTTP 2xx 且响应 code=0;异步任务还需查询最终状态。

请求字段

字段类型必填说明
idinteger是创作者账号 ID(creator account id)
productIdsstring[]是要移除的商品 ID 列表,1~200 个
所需 scope:creator.showcase.write。
一次最多移除 200 个 productId。
成功时 data 为 null,接口不返回逐项结果,需以整体 code 判断是否成功。
平台返回 16015001 时转成业务错误「商品已不在橱窗中,请刷新列表后重试」,通常表示商品已不在橱窗或 ID 有误。
平台返回 16015027 系统错误时错误码原样返回,可重试。
创作者授权失效时返回「授权过期,请重新授权」,同时把该达人账号置为失效;缺少权限时返回「该达人未授予此功能需要的权限」,不会把账号置为失效。
请求体
{
  "id": 12345,
  "productIds": [
    "12390753231",
    "7102893481290"
  ]
}
成功响应
{
  "code": 0,
  "message": "success",
  "data": null,
  "timestamp": 1790640000000
}

响应与错误

主要响应字段来自接口规范;完整层级、联合类型和校验规则见 JSON Schema。必填指字段所在对象中的约束。

字段类型必填说明
codeinteger是业务状态码,0 表示成功。
messagestring是—
datanull是本接口无业务数据返回。
timestampinteger是Unix 时间戳,单位毫秒。
  • HTTP 400请求参数或请求体无效,请修正后重试。
  • HTTP 401API 密钥缺失或无效,请检查 x-api-key。
  • HTTP 403API 密钥没有此接口的调用权限。
  • HTTP 429请求过于频繁,请采用指数退避重试。
  • HTTP 500服务端发生错误;对于暂时性故障采用指数退避重试。

参数、权限或授权错误需先修正。创建发布或生成任务超时后先查询已有任务,避免重复创建;不要因轮询中断而重复提交。

最后更新 · 2026-11-16