歌曲管理
获取匹配歌曲的 ID 列表
与 /songs 共享过滤条件,仅返回 ID。用于「全选当前筛选范围」场景。
get/songs/ids
Query parameters
typestring
歌曲类型
keywordstring
搜索关键词
path_prefixstring
按 file_path 前缀过滤
genrestring
按流派精确过滤
artiststring
按歌手精确过滤
albumstring
按专辑精确过滤
languagestring
按语种精确过滤
stylestring
按风格精确过滤
yearinteger
按发行年份精确过滤
decadeinteger
按年代过滤(起始年,如 1990 匹配 1990-1999)
exclude_playlist_labelsstring
排除属于这些 label 歌单的歌曲(逗号分隔), 默认 hidden; 传 none 显示全部
sort'id' | 'title' | 'artist' | 'album' | 'duration' | 'added_at' | 'updated_at' | 'file_modified_at' | 'year' | 'genre'
排序字段,缺省 added_at
order'asc' | 'desc'
排序方向,缺省 desc
Response
成功返回 ID 列表
object required