用户操作（某些操作需管理员权限，例如修改其他用户）

POST

/api/v2/user

按 action 执行用户相关操作：update 更新当前用户信息（管理员可通过 ?id= 更新其他用户）；change-password 修改当前用户密码（管理员可通过 ?id= 代改且无需旧密码）；follow 关注或取消关注指定用户（body 需 userId 与 action=follow/unfollow）；me 获取当前登录用户信息。均需要 JWT 鉴权，部分操作要求管理员权限。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Query 参数

Body 参数application/json必填

示例

{
    "username": "string",
    "bio": "string",
    "avatar_url": "string",
    "milkloud_id": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.xhsr.org.cn/api/v2/user?action=' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "username": "string",
    "bio": "string",
    "avatar_url": "string",
    "milkloud_id": "string"
}'

返回响应

🟢200

操作成功

该响应没有 Body

🟠400

🟠401

🟠403

🔴500

修改于 2026-10-07 10:19:10

获取用户信息或用户列表

管理员查询