歌曲管理

获取匹配歌曲的 ID 列表

Changed on

与 /songs 共享过滤条件，仅返回 ID。用于「全选当前筛选范围」场景。

get/songs/ids

Request

  • Base URL: https://localhost:58091/api/v1
  • URL: https://localhost:58091/api/v1/songs/ids
  • Auth: API key in header Authorization

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' | 'file_size'

排序字段，缺省 added_at

order'asc' | 'desc'

排序方向，缺省 desc

Response

成功返回 ID 列表

object required

Changes

  • 9f0f00626325Revision changes
    • info

      added the new optional query request parameter album

    • info

      added the new optional query request parameter artist

    • info

      added the new optional query request parameter decade

    • info

      added the new optional query request parameter genre

    • info

      added the new optional query request parameter language

    • info

      added the new optional query request parameter style

    • info

      added the new optional query request parameter year

  • ace6861ad4acRevision changes
    • info

      added the new optional query request parameter exclude_playlist_labels