跳到主要内容

用户与社交

GET /cm/users/square​

用户发现广场(含 ipRegion IP 属地:省份/国家,空串=未知)

权限:公开。

请求参数​

位置字段默认/读取方式
querylimit30(空值时回退)
querylistening未在 get 中指定
queryoffset0(空值时回退)
queryquery''(空值时回退)
querysort'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 属地,省份/国家,空串=未知)

权限:公开。

请求参数​

位置字段默认/读取方式
pathid路径占位符;按业务替换

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

参数校验与业务错误​

HTTP服务端校验说明
404'用户不存在'

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

请求模板​

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

curl --request GET 'https://music.20110208.xyz/cm/users/{id}/profile'

返回结构​

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

HTTP 200

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

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