用户管理指南 🛠️
欢迎使用用户管理API文档!以下是核心功能说明:
📌 基本概念
用户数据结构
每个用户包含以下字段:user_id
(唯一标识) |username
(登录名) |email
(邮箱) |roles
(权限角色)API端点
GET /users
:获取所有用户列表POST /users
:创建新用户PUT /users/{id}
:更新用户信息DELETE /users/{id}
:删除用户
📋 请求参数示例
方法 | 参数 | 描述 |
---|---|---|
POST | username |
必填,长度需≥3 |
PUT | roles |
支持 admin /editor /viewer 角色 |
DELETE | permanent |
布尔值,确认删除操作 |
✅ 响应格式
成功响应:
{
"status": "success",
"data": [{"user_id": 1, "username": "dev_user"}]
}
错误响应:
{
"status": "error",
"message": "用户不存在"
}
如需了解用户认证相关流程,请参考:认证指南 🔐