歌曲管理
曲库标签分类聚合
按指定维度聚合曲库,返回该维度下非空取值、各自的歌曲数量及一首代表歌曲的封面 URL,用于「分类浏览」的卡片网格。 支持维度:genre(流派)/artist(歌手)/album(专辑)/language(语种)/style(风格)/year(年份)/decade(年代)。 year/decade 的 value 为数字字符串(年代如 "1990" 表示 1990-1999)。取到某取值后可用 /songs?<field>=<value> 拉取该分类下歌曲。 支持 keyword 模糊搜索取值、limit/offset 分页、sort(count|name)/order 排序;返回 total 为该维度去重取值总数。
get/songs/facets
Query parameters
field'genre' | 'artist' | 'album' | 'language' | 'style' | 'year' | 'decade' 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