Swagger 2.0Apache 2.0raw.githubusercontent.com2026-08-1216286388.8 KB

f4e77e17b61f

歌单管理

获取歌单歌曲 ID 列表

返回歌单内全部歌曲的 ID,不分页。sort/order 语义与 GET /playlists/{id}/songs 完全一致(同一套排序逻辑),省略时默认 position 升序。 用途:客户端需要知道「某首歌在歌单里排第几」时(如从播放历史里的某首歌接着往下播),用本端点拿到有序 ID 数组后取下标,即可直接作为 /playlists/{id}/songs 的 offset 使用(传相同的 sort/order),避免为此拉取全部歌曲对象。 形态与 GET /songs/ids 对齐。

get/playlists/{id}/song-ids

Path parameters

idinteger required

歌单 ID

Query parameters

sortstring

排序字段: position(默认)/added_at/title/artist/album/duration/updated_at/file_modified_at

orderstring

排序方向: asc(默认)/desc

Response

成功返回 {ids:[1,2,3], total:3}

object required