歌曲管理

随机获取歌曲

Changed on

与 /songs 共享过滤条件，随机返回 limit 首歌曲完整对象。用于「随机播放」场景。 返回字段与 GET /songs 一致（数组包裹在 songs 字段中），total 为实际返回数量。

get/songs/random

Request

  • Base URL: https://localhost:58091/api/v1
  • URL: https://localhost:58091/api/v1/songs/random
  • 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 显示全部

limitinteger

随机返回数量，默认 50，上限 500

Response

成功返回随机歌曲列表

object required

Changes