创建用户

POST

/api/v1/admin/users

管理员创建任意角色和初始状态的用户，是 POST /api/v1/admin/admins 的一般化。
响应只包含公开用户字段，永不返回口令、口令哈希或任何凭据材料。

权限：manage_users 为基线；role 为 admin 或 owner 时所需权限抬升为 manage_roles。
浏览器 Session 写操作必须同时携带 HttpOnly Session Cookie、CSRF Cookie 和 X-CSRF-Token。

错误码：

400：invalid_role、invalid_status、invalid_username、invalid_email、password_too_short、password_too_long、display_name_too_long、email_domain_not_allowed、csrf_invalid

403：admin_forbidden

409：username_already_registered、email_already_registered、owner_bootstrap_required

请求参数

Body 参数application/json必填

示例

{
    "username": "string",
    "email": "user@example.com",
    "password": "pa$$word_q",
    "display_name": "string",
    "invitation_code": "string",
    "role": "user",
    "status": "active"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/admin/users' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "string",
    "email": "user@example.com",
    "password": "pa$$word_q",
    "display_name": "string",
    "invitation_code": "string",
    "role": "user",
    "status": "active"
}'

返回响应

🟢201成功

application/json

创建成功，返回公开用户字段（不含凭据材料）

Bodyapplication/json

示例

{
    "id": 1,
    "username": "string",
    "email": "user@example.com",
    "display_name": "string",
    "status": "string",
    "role": "user",
    "created_at": "2019-08-24T14:15:22.123Z"
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🟠409

🟠413

🟠415

🟠422参数错误

🔴503服务器故障

修改于 2026-10-01 05:59:34

用户列表

设置用户状态