用户管理指南 🛠️

欢迎使用用户管理API文档!以下是核心功能说明:

📌 基本概念

  • 用户数据结构
    每个用户包含以下字段:
    user_id (唯一标识) | username (登录名) | email (邮箱) | roles (权限角色)

    user_management
  • API端点

    • GET /users:获取所有用户列表
    • POST /users:创建新用户
    • PUT /users/{id}:更新用户信息
    • DELETE /users/{id}:删除用户
    user_profile

📋 请求参数示例

方法 参数 描述
POST username 必填,长度需≥3
PUT roles 支持 admin/editor/viewer 角色
DELETE permanent 布尔值,确认删除操作

✅ 响应格式

成功响应:

{
  "status": "success",
  "data": [{"user_id": 1, "username": "dev_user"}]
}

错误响应:

{
  "status": "error",
  "message": "用户不存在"
}

如需了解用户认证相关流程,请参考:认证指南 🔐

user_authentication