开发者文档 / 带货内容发布

收藏音乐

POST/v1/creator/tiktokshop/music/favorite

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

请求字段

字段	类型	必填	说明
`musicId`	`string`	是	平台音乐 ID
`title`	`string`	否	标题；收藏匹配时不区分大小写
`author`	`string`	否	音乐艺人或作者
`duration`	`string`	否	时长快照
`coverUrl`	`string`	否	封面 URL 快照
`playUrl`	`string`	否	播放/试听 URL 快照

收藏音乐（幂等）。platform 由服务端固定为 TIKTOK_SHOP。已存在则刷新传入的非空展示字段（title/author/duration/coverUrl/playUrl）。 coverUrl / playUrl 建议取搜索结果 coverThumb.urlList[0]、playUrl.urlList[0]。

请求体

{
  "musicId": "7567668059796720391",
  "title": "Sunrise",
  "author": "Example artist",
  "duration": "30",
  "coverUrl": "https://cdn.example.com/music-cover.jpg",
  "playUrl": "https://cdn.example.com/music.mp3"
}

成功响应

{
  "code": 0,
  "message": "success",
  "data": null,
  "timestamp": 1790640000000
}

响应与错误

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

字段	类型	必填	说明
`code`	`integer`	否	—
`message`	`string`	否	—
`data`	`null`	否	—
`timestamp`	`integer`	否	—

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

最后更新 · 2026-09-29