歌曲管理
获取歌曲列表
获取歌曲列表,支持按类型过滤、关键词搜索和分页。默认排除隐藏歌单里的歌,传 exclude_playlist_labels=none 显示全部
get/songs
Query parameters
type'local' | 'remote' | 'radio'
歌曲类型
keywordstring
搜索关键词
path_prefixstring
按 file_path 前缀过滤(如 music/Pop)
genrestring
按流派精确过滤
artiststring
按歌手精确过滤
albumstring
按专辑精确过滤
languagestring
按语种精确过滤
stylestring
按风格精确过滤
yearinteger
按发行年份精确过滤
decadeinteger
按年代过滤(起始年,如 1990 匹配 1990-1999)
exclude_playlist_labelsstring
排除属于这些 label 歌单的歌曲(逗号分隔), 默认 hidden; 传 none 显示全部
limitinteger
每页数量
offsetinteger
偏移量
sort'id' | 'title' | 'artist' | 'album' | 'duration' | 'added_at' | 'updated_at' | 'file_modified_at' | 'year' | 'genre'
排序字段,缺省 added_at
order'asc' | 'desc'
排序方向,缺省 desc
Response
成功返回歌曲列表
object required