Sign in
歌曲管理

获取歌曲列表

获取歌曲列表，支持按类型过滤、关键词搜索和分页。默认排除隐藏歌单里的歌，传 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' | 'file_size'

排序字段，缺省 added_at

order'asc' | 'desc'

排序方向，缺省 desc

Response

成功返回歌曲列表

object required

Changes

Changed in 4 of the 79 revisions of this API.11522

  • 9f0f006263257See the full diff
    • ○

      added the new optional query request parameter album

      new-optional-request-parameter

    • ○

      added the new optional query request parameter artist

      new-optional-request-parameter

    • ○

      added the new optional query request parameter decade

      new-optional-request-parameter

    • ○

      added the new optional query request parameter genre

      new-optional-request-parameter

    • ○

      added the new optional query request parameter language

      new-optional-request-parameter

    • ○

      added the new optional query request parameter style

      new-optional-request-parameter

    • ○

      added the new optional query request parameter year

      new-optional-request-parameter

  • ace6861ad4ac12See the full diff
    • ○

      the endpoint scheme security BearerAuth was added to the API

      api-security-added

    • ○

      api tag 歌曲管理 added

      api-tag-added

    • ○

      added the new optional query request parameter exclude_playlist_labels

      new-optional-request-parameter

    • ○

      added the new optional query request parameter keyword

      new-optional-request-parameter

    • ○

      added the new optional query request parameter limit

      new-optional-request-parameter

    • ○

      added the new optional query request parameter offset

      new-optional-request-parameter

    • ○

      added the new optional query request parameter order

      new-optional-request-parameter

    • ○

      added the new optional query request parameter path_prefix

      new-optional-request-parameter

    • ○

      added the new optional query request parameter sort

      new-optional-request-parameter

    • ○

      added the new optional query request parameter type

      new-optional-request-parameter

    • ○

      added the non-success response with the status 500

      response-non-success-status-added

    • ○

      added the success response with the status 200

      response-success-status-added

  • f3f029d9bc4a153See the full diff
    • ▲

      removed the success response with the status 200

      response-success-status-removed

    • ●

      deleted the query request parameter keyword

      request-parameter-removed

    • ●

      deleted the query request parameter limit

      request-parameter-removed

    • ●

      deleted the query request parameter offset

      request-parameter-removed

    • ●

      deleted the query request parameter path_prefix

      request-parameter-removed

    • ●

      deleted the query request parameter type

      request-parameter-removed

    • ○

      the endpoint scheme security BearerAuth was removed from the API

      api-security-removed

    • ○

      api tag 歌曲管理 removed

      api-tag-removed

    • ○

      removed the non-success response with the status 500

      response-non-success-status-removed

  • be19914b7eed10See the full diff
    • ●

      deleted the query request parameter album

      request-parameter-removed

    • ●

      deleted the query request parameter artist

      request-parameter-removed

    • ●

      deleted the query request parameter decade

      request-parameter-removed

    • ●

      deleted the query request parameter exclude_playlist_labels

      request-parameter-removed

    • ●

      deleted the query request parameter genre

      request-parameter-removed

    • ●

      deleted the query request parameter language

      request-parameter-removed

    • ●

      deleted the query request parameter order

      request-parameter-removed

    • ●

      deleted the query request parameter sort

      request-parameter-removed

    • ●

      deleted the query request parameter style

      request-parameter-removed

    • ●

      deleted the query request parameter year

      request-parameter-removed