跳到主要内容

注册新用户

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