歌单相关 API​

歌单相关 API ​歌单分类、歌单详情、新歌专辑等接口。

获取歌单列表 ​获取歌单列表，支持分类筛选。

接口： GET /getSongLists

参数：

参数类型必填说明categoryIdnumber否分类 IDsortIdnumber否排序方式limitnumber否每页数量pagenumber否页码示例：

bashcurl "http://localhost:3200/getSongLists?limit=20"响应：

json{

"code": 0,

"msg": "success",

"data": {

"playlists": [

{

"dissname": "歌单名",

"creator": "创建者",

"listen_num": 1234567

}

]

}

}获取歌单分类 ​获取所有歌单分类信息。

接口： GET /getSongListCategories

示例：

bashcurl "http://localhost:3200/getSongListCategories"响应：

json{

"code": 0,

"msg": "success",

"data": {

"categories": [

{

"id": 1,

"name": "华语"

}

]

}

}获取歌单详情 ​获取指定歌单的详细信息和歌曲列表。

接口： GET /getSongListDetail

参数：

参数类型必填说明disstidstring是歌单 ID示例：

bashcurl "http://localhost:3200/getSongListDetail?disstid=123456789"响应：

json{

"code": 0,

"msg": "success",

"data": {

"dissname": "歌单名",

"desc": "歌单描述",

"songlist": [

{

"songname": "歌曲名",

"singer": "歌手名"

}

]

}

}批量获取歌单 ​批量获取多个歌单信息。

接口： POST /batchGetSongLists

参数：

参数类型必填说明disstidstring是歌单 ID 列表（逗号分隔）示例：

bashcurl -X POST http://localhost:3200/batchGetSongLists \

-H "Content-Type: application/json" \

-d '{"disstid": "123456,789012"}'获取新碟上架 ​获取最新上架的专辑。

接口： GET /getNewDisks

参数：

参数类型必填说明limitnumber否数量限制pagenumber否页码示例：

bashcurl "http://localhost:3200/getNewDisks?limit=20"响应：

json{

"code": 0,

"msg": "success",

"data": {

"albums": [

{

"albumName": "专辑名",

"singerName": "歌手名",

"publicTime": "2026-03-01"

}

]

}

}相关接口 ​音乐相关 API排行榜 API