Users 用户管理 模块 API 文档
基础信息
- Base URL:
/api/admin - 认证方式: JWT Bearer Token
数据库表
users— 用户表audit_logs— 审计日志表
接口列表
1. 获取用户列表
GET /api/admin/users
Query 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| start_date | string | 选填 | 创建时间起始 |
| end_date | string | 选填 | 创建时间截止 |
| role | string | 选填 | 角色筛选（admin/developer/user） |
| status | string | 选填 | 状态筛选 |
响应:
[{
"id": "string",
"phone": "string",
"nickname": "string",
"email": "string",
"role": "user|admin|developer",
"status": "active|banned",
"subscription_plan": "free|pro",
"subscription_expires_at": "ISO8601",
"last_login_at": "ISO8601",
"created_at": "ISO8601",
"is_guest": 0|1
}]
2. 修改用户角色
PUT /api/admin/users/:userId/role
请求体:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| role | string | 必填 | admin | developer | user |
响应: {"success": true}
审计: 操作记入 audit_logs，action 为
change_user_role_to_{role}3. 修改用户状态
PUT /api/admin/users/:userId/status
请求体:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | string | 必填 | 用户状态 |
响应: {"success": true}
4. 清除所有游客账号
POST /api/admin/users/clear-guests
说明: 删除所有 is_guest=1 的用户及其关联数据（bills, bill_members），需先删除子表再删主表
响应: {"success": true, "deleted": 5}
5. 重置用户密码
POST /api/admin/users/:userId/reset-password
请求体:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| password | string | 必填 | 新密码（至少6位） |
响应: {"success": true}