补充技能说明

2026-05-20 14:59:18 +08:00
parent 96d894d1e0
commit bd04444d9d
38 changed files with 618 additions and 83 deletions
@@ -23,3 +23,14 @@ version: 3.0.0
 | POST | `/api/v1/users/{user_id}/deactivate` | 停用用户 | user_id (path) | - |

 - 覆盖方法：`DELETE, GET, POST, PUT`
+
+## 接口说明
+
+| 接口 | 说明 |
+|---|---|
+| `GET /users/` | 列出系统中所有用户（管理员权限），支持分页（skip/limit） |
+| `GET /users/{user_id}` | 按用户ID查询单个用户的详细信息 |
+| `PUT /users/{user_id}` | 更新指定用户的信息（邮箱、角色、密码等），请求体为 user_update 对象 |
+| `DELETE /users/{user_id}` | 删除指定用户（软删除或硬删除） |
+| `POST /users/{user_id}/activate` | 激活指定用户账号（管理员操作） |
+| `POST /users/{user_id}/deactivate` | 停用指定用户账号（禁止登录，管理员操作） |