客户端与资源
GET /cm/cast/{id}
客户端与资源 · /cast/{id}
权限：CurrentMusic Bearer 登录态；房间/绑定等条件另见校验。
请求参数
| 位置 | 字段 | 默认/读取方式 |
|---|---|---|
| path | id | 路径占位符；按业务替换 |
| query | exp | 未在 get 中指定 |
| query | level | 'auto'（空值时回退） |
| query | sig | 未在 get 中指定 |
| query | warm | 未在 get 中指定 |
表格列出实际代码读取的字段；get 的默认值不等于业务可省略。必填、长度和取值约束见下方校验及关联专题。
参数校验与业务错误
| HTTP | 服务端校验说明 |
|---|---|
| 401 | '投屏地址无效或已过期，请重新在 App 内发起投屏' |
| 502 | '音频缓存不可用' |
| 502 | f'音源获取失败: {e}' |
| 503 | '投屏并发数已达上限，请稍后再试' |
说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。
请求模板
将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。
curl --request GET 'https://music.20110208.xyz/cm/cast/{id}?warm=<warm>&level=<level>&exp=<exp>&sig=<sig>' \
--header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'
返回结构
以下是实现中直接返回的字段与取值表达式，不是一次真实请求的响应示例。条件分支可能返回不同结构。
HTTP 200
| 字段 | 取值/生成逻辑 |
|---|---|
ok | True |
level | lv_ |
ext | ext_ |
url | f'{base}/cm/cast/{ncm_id}?level={quote(str(level))}&exp={exp}&sig={sig}' |
expiresAt | exp |
实现定位：backend/cm_server.py:4848。接口参数和返回条件均来自该路由分支。
GET /cm/cast/{id}.lrc
客户端与资源 · /cast/{id}.lrc
权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。
请求参数
| 位置 | 字段 | 默认/读取方式 |
|---|---|---|
| path | id | 路径占位符；按业务替换 |
表格列出实际代码读取的字段；get 的默认值不等于业务可省略。必填、长度和取值约束见下方校验及关联专题。
请求模板
将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。
curl --request GET 'https://music.20110208.xyz/cm/cast/{id}.lrc' \
--header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'
返回类型
此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。
实现定位：backend/cm_server.py:4811。接口参数和返回条件均来自该路由分支。
GET /cm/download/latest
客户端与资源 · /download/latest
权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。
参数校验与业务错误
| HTTP | 服务端校验说明 |
|---|---|
| 404 | '安装包不存在' |
| 404 | '暂无发布记录' |
说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。
请求模板
将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。
curl --request GET 'https://music.20110208.xyz/cm/download/latest' \
--header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'
返回类型
此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。
实现定位：backend/cm_server.py:4048。接口参数和返回条件均来自该路由分支。
GET /cm/download/{filename}
客户端与资源 · /download/{filename}
权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。
请求参数
| 位置 | 字段 | 默认/读取方式 |
|---|---|---|
| path | filename | 路径占位符；按业务替换 |
表格列出实际代码读取的字段；get 的默认值不等于业务可省略。必填、长度和取值约束见下方校验及关联专题。
参数校验与业务错误
| HTTP | 服务端校验说明 |
|---|---|
| 404 | '安装包不存在' |
说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。
请求模板
将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。
curl --request GET 'https://music.20110208.xyz/cm/download/{filename}' \
--header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'
返回类型
此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。
实现定位：backend/cm_server.py:4065。接口参数和返回条件均来自该路由分支。
GET /cm/x/download/latest
客户端与资源 · /x/download/latest
权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。
参数校验与业务错误
| HTTP | 服务端校验说明 |
|---|---|
| 404 | '镜像尚未同步，请稍后再试' |
说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。
请求模板
将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。
curl --request GET 'https://music.20110208.xyz/cm/x/download/latest' \
--header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'
返回类型
此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。
实现定位：backend/cm_server.py:4078。接口参数和返回条件均来自该路由分支。
GET /cm/x/download/{filename}
客户端与资源 · /x/download/{filename}
权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。
请求参数
| 位置 | 字段 | 默认/读取方式 |
|---|---|---|
| path | filename | 路径占位符；按业务替换 |
表格列出实际代码读取的字段；get 的默认值不等于业务可省略。必填、长度和取值约束见下方校验及关联专题。
参数校验与业务错误
| HTTP | 服务端校验说明 |
|---|---|
| 404 | '安装包不存在（可能已被更新的版本替换）' |
说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。
请求模板
将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。
curl --request GET 'https://music.20110208.xyz/cm/x/download/{filename}' \
--header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'
返回类型
此分支使用专用处理器、文件或事件流响应，或在共享分支中组装 JSON。具体结构见对应专题；文件流不能按 JSON 解析。
实现定位：backend/cm_server.py:4136。接口参数和返回条件均来自该路由分支。
GET /cm/x/version/latest
客户端与资源 · /x/version/latest
权限：路由未直接调用登录检查；委托处理器可能另行校验，见说明。
参数校验与业务错误
| HTTP | 服务端校验说明 |
|---|---|
| 404 | '镜像尚未同步，请稍后再试' |
| 500 | '镜像元数据损坏，等待下次同步' |
说明中的变量表达式表示运行时值；另有统一的认证、频控和上游错误。
请求模板
将 {id} 等占位符和字段值替换为实际数据，令牌只使用你自己的 CurrentMusic 会话。
curl --request GET 'https://music.20110208.xyz/cm/x/version/latest' \
--header 'Authorization: Bearer YOUR_CURRENTMUSIC_TOKEN'
返回结构
以下是实现中直接返回的字段与取值表达式，不是一次真实请求的响应示例。条件分支可能返回不同结构。
HTTP 200
| 字段 | 取值/生成逻辑 |
|---|---|
响应体 | out |
实现定位：backend/cm_server.py:4106。接口参数和返回条件均来自该路由分支。