使用短信登录

发送登录验证码

  • 验证码有效期为5分钟,120秒以后可以重发
  • 请求地址 /v1/user/sendLoginMessage POST
  • 请求方式 JSON/Http POST
  • 请求参数
字段 类型 说明
countryCode 字符串 手机号的国家码 , 默认为 86(PRC)
phone 字符串 用于接受短信的手机号
  • 返回和请求示例:

POST /v1/user/sendLoginMessage

  1. {
  2. "phone":"13800138001"
  3. }

返回

  1. {
  2. "status": 200,
  3. "result": "T0RZLi5xenktc3AtdG9rZW5ANmNzOTJkLXRva2VuLk1UTTJNamN4TkRBME9ETS4ucXp5LXNwLXRva2VuQDZjczkyZC10b2tlbi5NakEuLnF6eS1zcC10b2tlbkA2Y3M5MmQtdG9rZW4uN2JjYWZkYjA1ZGEzNzM0ZTAxYWMzODVkNjFlYzRjMWE.",
  4. "code": "OK",
  5. "success": true
  6. }

可能遇到的错误

错误码(code字段) 状态码(已经废弃) 描述
{PHONE}_REQUIRED 400 字段:phone 不能为空
{NAME}_EXISTS 400 用户名已经存在
USER_LOGIN_FAILED 400 用户登录失败
USER_PHONE_NOT_EXIST 400 电话号码对应的用户不存在

第二步,发送登录信息

  1. /v1/user/loginByMessage
  1. {
  2. "phoneInfo":"T0RZLi5xenktc3AtdG9rZW5ANmNzOTJkLXRva2VuLk1UTTJNamN4TkRBME9ETS4ucXp5LXNwLXRva2VuQDZjczkyZC10b2tlbi5NakEuLnF6eS1zcC10b2tlbkA2Y3M5MmQtdG9rZW4uN2JjYWZkYjA1ZGEzNzM0ZTAxYWMzODVkNjFlYzRjMWE.",
  3. "code":"026129"
  4. }

如果成功,返回:

  1. {
  2. "status": 200,
  3. "result": {
  4. "uuid": 5,
  5. "name": "eric",
  6. "email": "",
  7. "countryCode": "86",
  8. "phone": "13800138001",
  9. "createTime": 1532526039883,
  10. "createIp": "::ffff:123.59.101.208",
  11. "ssid": {},
  12. "icon": "default.jpg",
  13. "spaceUsed": 0,
  14. "spaceCapacity": 8192,
  15. "type": 0,
  16. "status": 0
  17. },
  18. "code": "OK",
  19. "success": true,
  20. "token": "..."
  21. }

如果验证码无效:

  1. {
  2. "success": false,
  3. "message": "Code not valid",
  4. "code": "{CODE}_NOT_VALID",
  5. "status": 400
  6. }

肯能出现的错误

错误码(code字段) 状态码(已经废弃) 描述
{CODE }_REQUIRED 400 字段:code 不能为空
{PHONE_INFO}_REQUIRED 400 字段:phoneInfo 不能为空
USER_NOT_FOUND 400 用户名不存在
USER_LOGIN_FAILED 400 用户登录失败
USER_PHONE_NOT_EXIST 400 电话号码不存在
{CODE}_NOT_VALID 400 验证码无效