注册本地账号

POST

/api/user/register

用户注册

🔓 无需鉴权

本地契约说明

路由：POST /api/user/register

注册处理器：github.com/QuantumNous/new-api/controller.Register。

消费方：web_vue。

鉴权：匿名。路由未挂 UserAuth；仍受限流、Turnstile、一次性 flow token 或服务端业务校验约束。

字段状态：controller-confirmed。字段为动态上游数据或回调负载时，文档会明确标记，不能补造 Schema。

页面/功能：注册页创建本地账号。该接口不会自动登录。

前端传参：必传 username 与 password；email/verification_code 只在 status.email_verification=true 时必传；aff_code 可选。Turnstile 启用时附带 turnstile query。password 仅提交，不能持久化。

前端展示：仅显示 success/message；成功后引导用户前往登录，不得假定返回 access token。

调试：使用本操作的 x-debug 里的占位符；示例不含真实密码、API Key、签名、Cookie 或 Provider 密钥。

请求参数

Query 参数

Body 参数application/json必填

示例

{
    "username": "debug-user",
    "password": "<redacted-password>",
    "email": "debug@example.test",
    "verification_code": "<redacted-email-code>",
    "aff_code": ""
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://api-dev.opensosen.cn/api/user/register?turnstile=undefined' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "debug-user",
    "password": "<redacted-password>",
    "email": "debug@example.test",
    "verification_code": "<redacted-email-code>",
    "aff_code": ""
}'

返回响应

🟢200

application/json

管理端业务响应。HTTP 200 不代表业务成功，必须检查 success。

Bodyapplication/json

示例

成功业务失败仍可能使用 HTTP 200

{
    "success": true,
    "message": ""
}

🟠429

修改于 2026-08-14 17:19:51

完成 Passkey 登录

用邮件重置令牌生成一次性新密码

注册本地账号

本地契约说明#

请求参数

请求示例代码

返回响应

本地契约说明