内容资源列表API
更新时间：2026-05-15
内容资源列表
接口描述
内容资源查询 (list)，可以根据资源名称、专辑名称、资源id、歌手、资源类别查询相关内容资源
权限说明
该API的安全认证一律采用Access Key与请求签名机制。 鉴权认证机制的详细内容请参见 鉴权认证
请求语法
JSON
1POST /api/v{version}/content/data/content/list HTTP/1.1
2host: rtc-aiagent.baidubce.com
3content-type: application/json
4authorization: <bce-authorization-string>请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| page | int | 否 | 页数，默认值为1 |
| pageSize | int | 否 | 每页数量，默认值为20 |
| name | String | 否 | 资源名称 |
| albumName | String | 否 | 专辑名称 |
| albumArtist | String | 否 | 歌手 |
| trackId | String | 否 | 资源id |
| categoryName | String | 否 | 类别 (音乐、儿童、小说、戏曲、评书、相声、资讯、其他、人文、广播剧、故事、白噪声) |
| format | String | 否 | 内容资源格式（mp3、m4a） |
| updateStartTime | String | 否 | 查询资源更新开始时间（UTC），最早时间：2026-05-16T00:00:00Z，格式要求：yyyy-mm-ddTHH:mm:ssZ |
| updateEndTime | String | 否 | 查询资源更新结束时间（UTC），格式要求：yyyy-mm-ddTHH:mm:ssZ |
请求示例
JSON
1POST /api/v1/content/data/content/list HTTP/1.1
2host: rtc-aiagent.baidubce.com
3content-type: application/json
4authorization: {bce-authorization-string}
5x-bce-request-id: {bce-request-id}
6
7{
8 "page":5,
9 "pageSize": 2,
10 "name":"儿歌",
11 "albumName":"",
12 "albumArtist":"",
13 "trackId":"",
14 "albumId":"",
15 "categoryName":"",
16 "format":"m4a",
17 "updateStartTime":"",
18 "updateEndTime":""
19}响应参数
| 参数名 | 类型 | 描述 |
|---|---|---|
| page | int | 页数 |
| pageSize | int | 每页数量 |
| total | long | 符合条件的资源数量 |
| list | List | 查询结果 |
| |─ | object | |
| |─trackId | String | 内容资源id |
| |─name | String | 内容资源名称 |
| |─albumId | String | 专辑id |
| |─albumName | String | 专辑名称 |
| |─albumArtist | String | 歌手/作者 |
| |─categoryName | String | 类别 |
| |─available | boolean | 当前资源是否可用 |
| |─format | String | 内容资源格式 |
| |─updatedTime | Timestamp | 资源更新时间 |
响应示例
JSON
1HTTP/1.1 200 OK
2x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
3date: Mon, 05 Sep 2025 03:25:43 GMT
4transfer-encoding: chunked
5content-type: application/json;charset=UTF-8
6cache-control: no-cache
7{
8 "page": 5,
9 "pageSize": 2,
10 "total": 250,
11 "list": [
12 {
13 "trackId": "testTrackId1",
14 "name": "少儿歌曲1",
15 "albumId": "testAlbumId1",
16 "albumName": "少儿歌手推荐歌曲",
17 "albumArtist": "歌手1",
18 "categoryName": "儿童",
19 "episode": "第*集",
20 "available": true,
21 "format": "m4a",
22 "updatedTime": "2026-05-12T19:30:55.000+00:00"
23 },
24 {
25 "trackId": "testTrackId2",
26 "name": "少儿歌曲2",
27 "albumId": "testAlbumId2",
28 "albumName": "少儿歌手推荐歌曲",
29 "albumArtist": "歌手2",
30 "categoryName": "儿童",
31 "episode": "第*集",
32 "available": true,
33 "format": "m4a",
34 "updatedTime": "2026-05-12T19:30:55.000+00:00"
35 }
36 ]
37}评价此篇文章