注册用户

POST

/api/v1/users

公共注册在真实的邮件投递和验证令牌消费能力接入前 fail-closed。
格式合法的请求会返回 email_verification_unavailable，不会创建未证明邮箱所有权的 active 用户。
用户名和邮箱的唯一冲突统一返回 registration_conflict，不暴露具体冲突字段。

请求参数

Body 参数application/json必填

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢201成功

application/json

注册成功

Bodyapplication/json

示例

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

🟠400请求有误

🟠403禁止访问

🟠409

🟠413服务器故障

🟠415参数错误

🟠422参数错误

🟠429服务器故障

🔴503服务器故障

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

按数字 App ID 查询已发布的 Android 包名

用户登录