头像挂件

GET /cm/decorations

头像挂件 · /decorations

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

请求模板

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

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

返回结构

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

HTTP 200

字段	取值/生成逻辑
version	cm_decor.catalog_version()
minListenMs	cm_db.DECOR_MIN_MS
listenMs	ms
unlocked	bool(unlocked)
current	mine
scales	{d['id']: d['scale'] for d in cat}
decorations	[{'id': d['id'], 'name': d['name'], 'description': d['description'], 'format': d['format'], 'wi

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

PUT /cm/decorations/mine

头像挂件 · /decorations/mine

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

请求参数

位置	字段	默认/读取方式
JSON body	id	''（空值时回退）

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

参数校验与业务错误

HTTP	服务端校验说明
403	f'听歌时长满 2 小时才能设置头像挂件（还差约 {left} 分钟）'
404	'挂件不存在或已下架'

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

请求模板

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

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

返回结构

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

HTTP 200

字段	取值/生成逻辑
avatarDecoration	out['avatarDecoration']

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

GET /cm/decorations/scales

头像挂件 · /decorations/scales

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

请求模板

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

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

返回结构

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

HTTP 200

字段	取值/生成逻辑
version	cm_decor.catalog_version()
scales	{d['id']: d['scale'] for d in cat}

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