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

收藏音乐列表

GET/v1/creator/tiktokshop/music/favorites

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

Query 参数

字段	类型	必填	说明
`pageNumber`	`integer`	否	页码，默认 1
`pageSize`	`integer`	否	每页条数，默认 10
`title`	`string`	否	按标题模糊搜索（忽略大小写），空则返回全部收藏

进入音乐选择页默认展示。按当前登录 companyId + userId + platform=TIKTOK_SHOP 隔离，最近收藏优先。封面/播放 URL 为收藏时快照，CDN 可能过期；发帖以 music id 为准。支持 query 参数 title：按收藏时快照的标题模糊搜索。

成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "list": [
      {
        "id": "7567668059796720391",
        "platform": "TIKTOK_SHOP",
        "title": "Sunrise",
        "author": "Example artist",
        "duration": "30",
        "coverUrl": "https://cdn.example.com/music-cover.jpg",
        "playUrl": "https://cdn.example.com/music.mp3",
        "favorited": true
      }
    ],
    "total": 1,
    "pageNumber": 1,
    "pageSize": 10,
    "totalPages": 1
  },
  "timestamp": 1790640000000
}

响应与错误

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

字段	类型	必填	说明
`code`	`integer`	否	—
`message`	`string`	否	—
`data`	`object`	否	—
`data.list`	`object[]`	否	—
`data.list[].id`	`string`	否	平台 musicId
`data.list[].platform`	`string`	否	如 TIKTOK_SHOP
`data.list[].title`	`string`	否	—
`data.list[].author`	`string`	否	—
`data.list[].duration`	`string`	否	—
`data.list[].coverUrl`	`string`	否	封面 URL 快照
`data.list[].playUrl`	`string`	否	播放/试听 URL 快照
`data.list[].favorited`	`boolean`	否	固定 true；固定值：true
`data.total`	`integer`	否	—
`data.pageNumber`	`integer`	否	—
`data.pageSize`	`integer`	否	—
`data.totalPages`	`integer`	否	—
`timestamp`	`integer`	否	—

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

最后更新 · 2026-09-29