用户与社交
GET /cm/users/square
用户发现广场(含 ipRegion IP 属地:省份/国家,空串=未知)
权限:公开。
请求参数
| 位置 | 字段 | 默认/读取方式 |
|---|---|---|
| query | limit | 30(空值时回退) |
| query | listening | 未在 get 中指定 |
| query | offset | 0(空值时回退) |
| query | query | ''(空值时回退) |
| query | sort | 'reg'(空值时回退) |
表格列出实际代码读取的字段;get 的默认值不等于业务可省略。必填、长度和取值约束见下方校验及关联专题。
参数校验与业务错误
| HTTP | 服务端校验说明 |
|---|---|
| 400 | '分页参数错误' |
说明中的变量表达式表示运行时值;另有统一的认证、频控和上游错误。
请求模板
将 {id} 等占位符和字段值替换为实际数据,令牌只使用你自己的 CurrentMusic 会话。
curl --request GET 'https://music.20110208.xyz/cm/users/square?sort=<sort>&limit=<limit>&offset=<offset>&listening=<listening>&query=<query>'
返回结构
以下是实现中直接返回的字段与取值表达式,不是一次真实请求的响应示例。条件分支可能返回不同结构。
HTTP 200
| 字段 | 取值/生成逻辑 |
|---|---|
响应体 | cm_db.square_users((q.get('query') or '').strip()[:50], q.get('sort') or 'reg', limit, offset, listening_only=q.get('listening') i |
实现定位:backend/cm_server.py:3593。接口参数和返回条件均来自该路由分支。
GET /cm/users/{id}/profile
公开用户主页(user.ipRegion = IP 属地,省份/国家,空串=未知)
权限:公开。
请求参数
| 位置 | 字段 | 默认/读取方式 |
|---|---|---|
| path | id | 路径占位符;按业务替换 |
表格列出实际代码读取的字段;get 的默认值不等于业务可省略。必填、长度和取值约束见下方校验及关联专题。
参数校验与业务错误
| HTTP | 服务端校验说明 |
|---|---|
| 404 | '用户不存在' |
说明中的变量表达式表示运行时值;另有统一的认证、频控和上游错误。
请求模板
将 {id} 等占位符和字段值替换为实际数据,令牌只使用你自己的 CurrentMusic 会话。
curl --request GET 'https://music.20110208.xyz/cm/users/{id}/profile'
返回结构
以下是实现中直接返回的字段与取值表达式,不是一次真实请求的响应示例。条件分支可能返回不同结构。
HTTP 200
| 字段 | 取值/生成逻辑 |
|---|---|
响应体 | prof |
实现定位:backend/cm_server.py:3604。接口参数和返回条件均来自该路由分支。