歌单管理

获取歌单歌曲 ID 列表

Changed on

返回歌单内全部歌曲的 ID，不分页。sort/order 语义与 GET /playlists/{id}/songs 完全一致（同一套排序逻辑），省略时默认 position 升序。 title（歌曲名称）/artist/album 按不区分大小写的拼音字母序排列，忽略首尾空白；中英文混排，多音字使用字典默认读音。排序键相同时按歌单 position 同方向排列。 用途：客户端需要知道「某首歌在歌单里排第几」时（如从播放历史里的某首歌接着往下播），用本端点拿到有序 ID 数组后取下标，即可直接作为 /playlists/{id}/songs 的 offset 使用（传相同的 sort/order），避免为此拉取全部歌曲对象。 形态与 GET /songs/ids 对齐。

get/playlists/{id}/song-ids

Request

  • Base URL: https://localhost:58091/api/v1
  • URL: https://localhost:58091/api/v1/playlists/{id}/song-ids
  • Auth: API key in header Authorization

Path parameters

idinteger required

歌单 ID

Query parameters

sortstring

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

orderstring

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

Response

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

object required

Changes