用户管理
用户管理接口用于管理用户账户。所有接口都需要管理员权限。
获取用户列表
获取用户列表。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| page | integer | 否 | 页码，默认1 |
| size | integer | 否 | 每页数量 |
| role | string | 否 | 用户角色 |
| status | string | 否 | 账户状态 |
GET /admin/user/list?page=1&size=10&role=user
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
获取用户数量
获取用户总数。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| role | string | 否 | 用户角色 |
| status | string | 否 | 账户状态 |
GET /admin/user/count?role=user&status=active
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
获取用户详情
获取指定用户的详细信息。请求参数
GET /admin/user/user_123
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
更新用户信息
更新指定用户的信息。请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|
| id | string | 是 | 用户ID |
| username | string | 否 | 用户名 |
| email | string | 否 | 邮箱 |
| phone | string | 否 | 电话 |
| status | string | 否 | 账户状态 |
| profile | object | 否 | 用户资料 |
PUT /admin/user/user_123
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
{
"username": "李四",
"email": "[email protected]",
"status": "inactive",
"profile": {
"bio": "更新后的个人简介"
}
}
切换用户身份
切换到指定用户的身份。请求参数
POST /admin/user/user_123/become
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN
错误码说明
错误码说明
| 错误码 | 说明 |
|---|
| 400 | 请求参数错误 |
| 401 | 未授权或令牌无效 |
| 403 | 权限不足（需要管理员权限） |
| 404 | 用户不存在 |
| 422 | 请求参数验证失败 |
| 500 | 服务器错误 |
