播放历史

GET /cm/plays/recent

最近播放

权限：Bearer。

请求参数

位置	字段	默认/读取方式
query	limit	50（空值时回退）

表格列出实际代码读取的字段；get 的默认值不等于业务可省略。必填、长度和取值约束见下方校验及关联专题。

请求模板

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

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

返回结构

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

HTTP 200

字段	取值/生成逻辑
响应体	_payload_recent(u, int(q.get('limit') or 50))

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

POST /cm/plays/{id}

播放历史 · /plays/{id}

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

请求参数

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

表格列出实际代码读取的字段；get 的默认值不等于业务可省略。必填、长度和取值约束见下方校验及关联专题。

请求模板

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

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

返回结构

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

HTTP 200

字段	取值/生成逻辑
ok	True

HTTP 200

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

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