Sign in
歌曲管理

曲库标签分类聚合

按指定维度聚合曲库，返回该维度下非空取值、各自的歌曲数量及一首代表歌曲的封面 URL，用于「分类浏览」的卡片网格。 支持维度：genre(流派)/artist(歌手)/album(专辑)/language(语种)/style(风格)/year(年份)/decade(年代)/tag(标签)。 year/decade 的 value 为数字字符串（年代如 "1990" 表示 1990-1999）。取到某取值后可用 /songs?<field>=<value> 拉取该分类下歌曲（tag 维度除外——tag 的 value 为标签名，需用 /songs?tag_name=<value> 过滤）。 支持 keyword 模糊搜索取值、limit/offset 分页、sort(count|name)/order 排序；返回 total 为该维度去重取值总数。

get/songs/facets

Query parameters

field'genre' | 'artist' | 'album' | 'language' | 'style' | 'year' | 'decade' | 'tag' required

聚合维度

keywordstring

对取值模糊搜索

limitinteger

分页大小，缺省 20，上限 100000

offsetinteger

分页偏移，缺省 0

sort'count' | 'name'

排序维度，缺省 count

order'asc' | 'desc'

排序方向；count 缺省 desc，name 缺省 asc

Response

成功返回聚合结果 {field, facets:[{value,count,cover_url}], total, limit, offset}

object required

Changes

Changed in 3 of the 79 revisions of this API.16

  • d345c291467b5See the full diff
    • ○

      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 sort

      new-optional-request-parameter

  • 9f0f006263251See the full diff
    • ○

      endpoint added

      endpoint-added

  • be19914b7eed1See the full diff
    • ▲

      api path removed without deprecation

      api-path-removed-without-deprecation