v56

latestSwagger 2.0Apache 2.0raw.githubusercontent.com2026-08-0616186383.8 KB
歌曲管理

曲库标签分类聚合

按指定维度聚合曲库,返回该维度下非空取值、各自的歌曲数量及一首代表歌曲的封面 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