平台与其他接口

GET /cm/artists/followed

平台接口 · /artists/followed

权限：CurrentMusic Bearer 登录态；房间/绑定等条件另见校验。

请求参数

位置	字段	默认/读取方式
query	`refresh`	未在 get 中指定

参数校验与业务错误

HTTP	服务端校验说明
400	'请先绑定网易云账号'
502	str(e)

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/artists/followed?refresh=<refresh>' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回结构

以下是实现中直接返回的字段与取值表达式，不是一次真实请求的响应示例。条件分支可能返回不同结构。

HTTP 200

字段	取值/生成逻辑
`响应体`	`d`

实现定位：backend/cm_server.py:3658。接口参数和返回条件均来自该路由分支。

POST /cm/artists/{id}/follow

关注/取关网易云歌手 {on}；写操作透传可信 RealIP

权限：Bearer。

请求参数

位置	字段	默认/读取方式
path	`id`	路径占位符；按业务替换
JSON body	`name`	''（空值时回退）
JSON body	`on`	True
JSON body	`pic`	''（空值时回退）

参数校验与业务错误

HTTP	服务端校验说明
400	'请先绑定网易云账号'
502	str(e2)

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request POST 'https://music.20110208.xyz/cm/artists/{id}/follow' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"on": "<on>", "name": "<name>", "pic": "<pic>"}'

返回结构

以下是实现中直接返回的字段与取值表达式，不是一次真实请求的响应示例。条件分支可能返回不同结构。

HTTP 200

字段	取值/生成逻辑
`ok`	`True`
`following`	`on`

实现定位：backend/cm_server.py:3710。接口参数和返回条件均来自该路由分支。

GET /cm/avatar/{filename}

平台接口 · /avatar/{filename}

权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。

请求参数

位置	字段	默认/读取方式
path	`filename`	路径占位符；按业务替换

参数校验与业务错误

HTTP	服务端校验说明
404	'头像不存在'

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/avatar/{filename}' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回类型

此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。

实现定位：backend/cm_server.py:3028。接口参数和返回条件均来自该路由分支。

GET /cm/bootstrap

控制台/客户端首屏聚合数据

权限：可选登录。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/bootstrap' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回结构

以下是实现中直接返回的字段与取值表达式，不是一次真实请求的响应示例。条件分支可能返回不同结构。

HTTP 200

字段	取值/生成逻辑
`响应体`	`out`

实现定位：backend/cm_server.py:1821。接口参数和返回条件均来自该路由分支。

GET /cm/console

平台接口 · /console

权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。

参数校验与业务错误

HTTP	服务端校验说明
404	'CurrentStation 控制台页面缺失'

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/console' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回类型

此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。

实现定位：backend/cm_server.py:2262。接口参数和返回条件均来自该路由分支。

GET /cm/daily

每日推荐

权限：可选登录。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/daily' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回结构

以下是实现中直接返回的字段与取值表达式，不是一次真实请求的响应示例。条件分支可能返回不同结构。

HTTP 200

字段	取值/生成逻辑
`响应体`	`_payload_daily(u)`

实现定位：backend/cm_server.py:5051。接口参数和返回条件均来自该路由分支。

GET /cm/decor/{id}

平台接口 · /decor/{id}

权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。

请求参数

位置	字段	默认/读取方式
path	`id`	路径占位符；按业务替换

参数校验与业务错误

HTTP	服务端校验说明
404	'挂件图片不存在'

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/decor/{id}' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回类型

此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。

实现定位：backend/cm_server.py:3107。接口参数和返回条件均来自该路由分支。

GET /cm/decor/{id}.apng

平台接口 · /decor/{id}.apng

权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。

请求参数

位置	字段	默认/读取方式
path	`id`	路径占位符；按业务替换

参数校验与业务错误

HTTP	服务端校验说明
404	'挂件图片不存在'

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/decor/{id}.apng' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回类型

此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。

实现定位：backend/cm_server.py:3107。接口参数和返回条件均来自该路由分支。

GET /cm/decor/{id}.gif

平台接口 · /decor/{id}.gif

权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。

请求参数

位置	字段	默认/读取方式
path	`id`	路径占位符；按业务替换

参数校验与业务错误

HTTP	服务端校验说明
404	'挂件图片不存在'

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/decor/{id}.gif' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回类型

此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。

实现定位：backend/cm_server.py:3107。接口参数和返回条件均来自该路由分支。

GET /cm/decor/{id}.png

平台接口 · /decor/{id}.png

权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。

请求参数

位置	字段	默认/读取方式
path	`id`	路径占位符；按业务替换

参数校验与业务错误

HTTP	服务端校验说明
404	'挂件图片不存在'

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/decor/{id}.png' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回类型

此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。

实现定位：backend/cm_server.py:3107。接口参数和返回条件均来自该路由分支。

GET /cm/developer

平台接口 · /developer

权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。

参数校验与业务错误

HTTP	服务端校验说明
404	'开发者平台页面缺失'

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/developer' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回类型

此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。

实现定位：backend/cm_server.py:2411。接口参数和返回条件均来自该路由分支。

GET /cm/health

服务健康检查

权限：公开。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/health'

返回结构

以下是实现中直接返回的字段与取值表达式，不是一次真实请求的响应示例。条件分支可能返回不同结构。

HTTP 200

字段	取值/生成逻辑
`ok`	`True`
`now`	`int(time.time())`

实现定位：backend/cm_server.py:1720。接口参数和返回条件均来自该路由分支。

GET /cm/img

平台接口 · /img

权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。

请求参数

位置	字段	默认/读取方式
query	`url`	''（空值时回退）

参数校验与业务错误

HTTP	服务端校验说明
400	str(e)
502	'目标不是图片'

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/img?url=<url>' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回类型

此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。

实现定位：backend/cm_server.py:4956。接口参数和返回条件均来自该路由分支。

POST /cm/meta

平台接口 · /meta

权限：CurrentMusic Bearer 登录态；房间/绑定等条件另见校验。

请求参数

位置	字段	默认/读取方式
JSON body	`songs`	未在 get 中指定

参数校验与业务错误

HTTP	服务端校验说明
400	'songs 列表需 ≤100 条'

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request POST 'https://music.20110208.xyz/cm/meta' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"songs": "<songs>"}'

返回结构

以下是实现中直接返回的字段与取值表达式，不是一次真实请求的响应示例。条件分支可能返回不同结构。

HTTP 200

字段	取值/生成逻辑
`ok`	`True`

实现定位：backend/cm_server.py:3122。接口参数和返回条件均来自该路由分支。

GET /cm/song/wiki

平台接口 · /song/wiki

权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。

请求参数

位置	字段	默认/读取方式
query	`id`	0（空值时回退）

参数校验与业务错误

HTTP	服务端校验说明
400	'缺少 id'

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/song/wiki?id=<id>' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回结构

以下是实现中直接返回的字段与取值表达式，不是一次真实请求的响应示例。条件分支可能返回不同结构。

HTTP 200

字段	取值/生成逻辑
`响应体`	`out`

HTTP 200

字段	取值/生成逻辑
`响应体`	`json.loads(cached)`

实现定位：backend/cm_server.py:3981。接口参数和返回条件均来自该路由分支。

GET /cm/station

平台接口 · /station

权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。

参数校验与业务错误

HTTP	服务端校验说明
404	'CurrentStation 控制台页面缺失'

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/station' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回类型

此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。

实现定位：backend/cm_server.py:2262。接口参数和返回条件均来自该路由分支。

GET /cm/station/api-catalog

平台接口 · /station/api-catalog

权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/station/api-catalog' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回结构

以下是实现中直接返回的字段与取值表达式，不是一次真实请求的响应示例。条件分支可能返回不同结构。

HTTP 200

字段	取值/生成逻辑
`version`	`'1.0'`
`generatedAt`	`int(time.time())`
`sources`	`{'netease': f'{base}/docs', 'backend': f'{base}/cm'}`
`groups`	`[{'id': 'backend', 'title': 'CurrentMusic 自有后端', 'items': own_out}, {'id': 'netease', 'title': &#x27`

实现定位：backend/cm_server.py:2271。接口参数和返回条件均来自该路由分支。

GET /cm/version/latest

平台接口 · /version/latest

权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。

参数校验与业务错误

HTTP	服务端校验说明
404	'暂无发布记录'

说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。

请求模板

将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。

curl --request GET 'https://music.20110208.xyz/cm/version/latest' \
  --header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'

返回结构

以下是实现中直接返回的字段与取值表达式，不是一次真实请求的响应示例。条件分支可能返回不同结构。

HTTP 200

字段	取值/生成逻辑
`响应体`	`out`

实现定位：backend/cm_server.py:4026。接口参数和返回条件均来自该路由分支。

GET /cm/artists/followed​

请求参数​

参数校验与业务错误​

请求模板​

返回结构​

POST /cm/artists/{id}/follow​

请求参数​

参数校验与业务错误​

请求模板​

返回结构​

GET /cm/avatar/{filename}​

请求参数​

参数校验与业务错误​

请求模板​

返回类型​

GET /cm/bootstrap​

请求模板​

返回结构​

GET /cm/console​

参数校验与业务错误​

请求模板​

返回类型​

GET /cm/daily​

请求模板​

返回结构​

GET /cm/decor/{id}​

请求参数​

参数校验与业务错误​

请求模板​

返回类型​

GET /cm/decor/{id}.apng​

请求参数​

参数校验与业务错误​

请求模板​

返回类型​

GET /cm/decor/{id}.gif​

请求参数​

参数校验与业务错误​

请求模板​

返回类型​

GET /cm/decor/{id}.png​

请求参数​

参数校验与业务错误​

请求模板​

返回类型​

GET /cm/developer​

参数校验与业务错误​

请求模板​

返回类型​

GET /cm/health​

请求模板​

返回结构​

GET /cm/img​

请求参数​

参数校验与业务错误​

请求模板​

返回类型​

POST /cm/meta​

请求参数​

参数校验与业务错误​

请求模板​

返回结构​

GET /cm/song/wiki​

请求参数​

参数校验与业务错误​

请求模板​

返回结构​

GET /cm/station​

参数校验与业务错误​

请求模板​

返回类型​

GET /cm/station/api-catalog​

请求模板​

返回结构​

GET /cm/version/latest​

参数校验与业务错误​

请求模板​

返回结构​

GET /cm/artists/followed

请求参数

参数校验与业务错误

请求模板

返回结构

POST /cm/artists/{id}/follow

请求参数

参数校验与业务错误

请求模板

返回结构

GET /cm/avatar/{filename}

请求参数

参数校验与业务错误

请求模板

返回类型

GET /cm/bootstrap

请求模板

返回结构

GET /cm/console

参数校验与业务错误

请求模板

返回类型

GET /cm/daily

请求模板

返回结构

GET /cm/decor/{id}

请求参数

参数校验与业务错误

请求模板

返回类型

GET /cm/decor/{id}.apng

请求参数

参数校验与业务错误

请求模板

返回类型

GET /cm/decor/{id}.gif

请求参数

参数校验与业务错误

请求模板

返回类型

GET /cm/decor/{id}.png

请求参数

参数校验与业务错误

请求模板

返回类型

GET /cm/developer

参数校验与业务错误

请求模板

返回类型

GET /cm/health

请求模板

返回结构

GET /cm/img

请求参数

参数校验与业务错误

请求模板

返回类型

POST /cm/meta

请求参数

参数校验与业务错误

请求模板

返回结构

GET /cm/song/wiki

请求参数

参数校验与业务错误

请求模板

返回结构

GET /cm/station

参数校验与业务错误

请求模板

返回类型

GET /cm/station/api-catalog

请求模板

返回结构

GET /cm/version/latest

参数校验与业务错误

请求模板

返回结构