feat:简单添加管理员后台功能
This commit is contained in:
@@ -409,4 +409,50 @@ curl -X POST http://localhost:3000/auth/reset-password \
|
||||
|
||||
## 更新日志
|
||||
|
||||
- **v1.0.0** (2025-12-17): 初始版本,包含基础的用户认证功能
|
||||
- **v1.0.0** (2025-12-17): 初始版本,包含基础的用户认证功能
|
||||
## 管理员接口
|
||||
|
||||
**注意**:所有管理员接口都需要在 Header 中携带 ,且用户角色必须为管理员 (role=9)。
|
||||
|
||||
### 1. 获取用户列表
|
||||
|
||||
**接口地址**: `GET /admin/users`
|
||||
|
||||
**功能描述**: 分页获取所有注册用户列表
|
||||
|
||||
#### 请求参数
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| page | number | 否 | 页码,默认1 |
|
||||
| limit | number | 否 | 每页数量,默认10 |
|
||||
|
||||
### 2. 重置用户密码
|
||||
|
||||
**接口地址**: `POST /admin/users/:id/reset-password`
|
||||
|
||||
**功能描述**: 管理员强制重置指定用户的密码
|
||||
|
||||
#### 请求参数
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| password | string | 是 | 新密码 |
|
||||
|
||||
### 3. 删除用户
|
||||
|
||||
**接口地址**: `DELETE /admin/users/:id`
|
||||
|
||||
**功能描述**: 删除指定用户
|
||||
|
||||
### 4. 修改用户角色
|
||||
|
||||
**接口地址**: `POST /admin/users/:id/role`
|
||||
|
||||
**功能描述**: 修改用户的角色权限
|
||||
|
||||
#### 请求参数
|
||||
|
||||
| 参数名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| role | number | 是 | 角色ID (1:普通用户, 9:管理员) |
|
||||
|
||||
Reference in New Issue
Block a user