跳到主要内容

注册新用户

POST 
/auth/v1/signup

注册新用户，支持以下三种注册场景：

1. 手机号+验证码注册​

入参要求：​

  • phone_number: 手机号（必填，格式："+86 13000000000"）
  • verification_token: 验证码token，必填，通过验证短信、邮箱验证码接口获取
  • username: 用户名（可选，2-48位）
  • password: 密码（可选）

出参：​

  • 返回标准的token响应（access_token、refresh_token等）

手机号+验证码注册请求示例​

{
  "phone_number": "+86 13000000000",
  "verification_token": "your_access_token",
  "username": "user123",
  "password": "Password@123"
}

手机号+验证码注册响应示例​

{
  "token_type": "Bearer",
  "access_token": "your_access_token",
  "refresh_token": "m.Y7Nk75cRMmeMrwYOqmG0Sju4YjZiiPRO-lE",
  "expires_in": 7200,
  "sub": "9876543210123456789"
}

2. 邮箱+验证码注册​

入参要求：​

  • email: 邮箱地址（必填）
  • verification_token: 验证码token，必填，通过验证短信、邮箱验证码接口获取
  • username: 用户名（可选，5-24位）
  • password: 密码（可选）

出参：​

  • 返回标准的token响应（access_token、refresh_token等）

邮箱+验证码注册请求示例​

{
  "email": "user@example",
  "verification_token": "your_access_token",
  "username": "user456",
  "password": "DemoPass123!@#"
}

邮箱+验证码注册响应示例​

{
  "token_type": "Bearer",
  "access_token": "your_access_token",
  "refresh_token": "m.Y7Nk75cRMmeMrwYOqmG0Sju4YjZiiPRO-lE",
  "expires_in": 7200,
  "sub": "9876543210123456789"
}

3. 第三方授权注册​

入参要求：​

  • provider_token: 第三方身份源token（必填）
  • username: 用户名（可选，5-24位）
  • password: 密码（可选）

出参：​

  • 返回标准的token响应（access_token、refresh_token等）

第三方授权注册请求示例​

{
  "provider_token": "your_provider_token",
  "username": "github_user",
  "password": "SamplePass456$%^"
}

第三方授权注册响应示例​

{
  "token_type": "Bearer",
  "access_token": "your_access_token",
  "refresh_token": "m.Y7Nk75cRMmeMrwYOqmG0Sju4YjZiiPRO-lE",
  "expires_in": 7200,
  "sub": "9876543210123456789"
}

通用说明：​

  • 可在注册时同时设置用户名、密码
  • 验证码注册时，需要通过验证短信、邮箱验证码接口获取verification_token
  • 不支持仅传入用户名、密码注册。用户名密码创建用户，请前往云后台创建

Request​

Responses​

A successful response.

Response Headers