# 收藏音乐列表

- API 版本：1.10.0
- 最后更新：2026-09-29
- 服务地址：`https://api.ailingtu.com`
- 网页文档：[收藏音乐列表](/openapi/favorite-music-list)
- 完整接口约束：[JSON Schema](/openapi/operations/listTikTokShopFavoriteMusic.json)
- 接口发现：[接口索引](/openapi/operations/index.json)

## GET /v1/creator/tiktokshop/music/favorites

接口标识：`listTikTokShopFavoriteMusic`

收藏音乐列表。

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

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

### 请求参数

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

### 成功响应

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

### 接入说明与限制

- 进入音乐选择页默认展示。按当前登录 companyId + userId + platform=TIKTOK_SHOP 隔离，最近收藏优先。

封面/播放 URL 为收藏时快照，CDN 可能过期；发帖以 music id 为准。

支持 query 参数 title：按收藏时快照的标题模糊搜索。

### 相关接口

- [搜索音乐](/openapi/search-music) · [Markdown](/openapi/operations/searchTikTokShopMusic.md)
- [收藏音乐](/openapi/favorite-music) · [Markdown](/openapi/operations/favoriteTikTokShopMusic.md)
- [取消收藏音乐](/openapi/unfavorite-music) · [Markdown](/openapi/operations/unfavoriteTikTokShopMusic.md)