37 lines
1.6 KiB
Markdown
37 lines
1.6 KiB
Markdown
---
|
||
name: tjwater-action-business-identity-access-user-management
|
||
description: business/identity-access 下 user-management 操作技能。
|
||
version: 3.0.0
|
||
---
|
||
|
||
# user-management Action Skill
|
||
|
||
## 简介
|
||
负责 `business/identity-access` 场景下 `user-management` 的具体接口调用。
|
||
|
||
## 子模块索引 (渐进式引导)
|
||
- 当前为叶子节点，直接使用下方接口目录。
|
||
|
||
## 接口目录
|
||
| Method | Path | Summary | Required Params | Optional Params |
|
||
|---|---|---|---|---|
|
||
| GET | `/api/v1/users/` | 列出所有用户 | - | skip (query), limit (query) |
|
||
| DELETE | `/api/v1/users/{user_id}` | 删除用户 | user_id (path) | - |
|
||
| GET | `/api/v1/users/{user_id}` | 获取用户详情 | user_id (path) | - |
|
||
| PUT | `/api/v1/users/{user_id}` | 更新用户信息 | user_id (path) | user_update (body) |
|
||
| POST | `/api/v1/users/{user_id}/activate` | 激活用户 | user_id (path) | - |
|
||
| 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` | 停用指定用户账号（禁止登录，管理员操作） |
|