跳到主要内容

注册新用户

POST 

/auth/v1/signup

注册新用户,适用场景:

  • 手机号+验证码注册新用户
  • 邮箱+验证码注册新用户
  • 第三方授权后获取provider_token注册新用户。

可在注册时同时设置用户名、密码。不支持仅传入用户名、密码注册。用户名密码创建用户,请前往云后台创建。

Request

Query Parameters

    client_id string

    应用对应的客户端id,可从云开发平台-->身份认证-->开发设置获取。默认为环境id,可以不传

Header Parameters

    x-device-id string

    设备id,当前登录设备的id。客户端应随机生成,并缓存到客户端。此参数与登录账号数有关

Body

    email 邮箱 (string)

    邮箱+verification_token注册时必传

    phone_number 手机号 (string)

    手机+verification_token注册时必传,+86不可省略。例如:"+86 13000000000"

    username 用户名 (string)

    长度5-24位,支持字符中英文、数字、特殊字符(仅支持_-),不支持中文

    verification_token 接收到的验证码Token (string)

    手机+verification_token或邮箱+verification_token注册时必传

    password optional password 密码 (string)
    name optional 昵称, 可选 (string)
    gender optional 头像, 符合css编码格式 (string)
    picture optional 头像, 符合css编码格式 (string)
    locale optional 地区, 可选 (如果地区为空, 则h后端会根据手机号码,ip地址等多种因素, 选择初始化地区) 格式: zh (string)
    provider_token 如果之前获取过三方信息, 则可以将三方信息绑定到该账号 (string)

    /auth/v1/provider/token等接口返回的provider_token

Responses

A successful response.

Response Headers
    Schema
      token_type 访问令牌类型 (string)

      统一返回 Bearer

      access_token 用户的访问令牌 (string)

      用于访问云开发HTTP API的令牌,长度4096位以内

      refresh_token 用户的刷新令牌 (string)

      access_token过期可通过refresh_token刷新获取新的access_token,过期时间默认为31天。长度128位以内

      expires_in int32

      access_token的过期时间,单位为秒

      scope 授权范围 (string)
      sub 用户的唯一id (string)
      groups string[]
    Loading...