Skip to content

Latest commit

 

History

History
96 lines (86 loc) · 3.2 KB

010.010.使用短信验证码登录.md

File metadata and controls

96 lines (86 loc) · 3.2 KB
Raw

返回目录

使用短信登录

发送登录验证码

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

POST /v1/user/sendLoginMessage

{
	"phone":"13800138001"
}

返回

{
    "status": 200,
    "result": "T0RZLi5xenktc3AtdG9rZW5ANmNzOTJkLXRva2VuLk1UTTJNamN4TkRBME9ETS4ucXp5LXNwLXRva2VuQDZjczkyZC10b2tlbi5NakEuLnF6eS1zcC10b2tlbkA2Y3M5MmQtdG9rZW4uN2JjYWZkYjA1ZGEzNzM0ZTAxYWMzODVkNjFlYzRjMWE.",
    "code": "OK",
    "success": true
}

可能遇到的错误

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

第二步，发送登录信息

/v1/user/loginByMessage

{
	"phoneInfo":"T0RZLi5xenktc3AtdG9rZW5ANmNzOTJkLXRva2VuLk1UTTJNamN4TkRBME9ETS4ucXp5LXNwLXRva2VuQDZjczkyZC10b2tlbi5NakEuLnF6eS1zcC10b2tlbkA2Y3M5MmQtdG9rZW4uN2JjYWZkYjA1ZGEzNzM0ZTAxYWMzODVkNjFlYzRjMWE.",
	"code":"026129"
}

如果成功，返回：

{
    "status": 200,
    "result": {
        "uuid": 5,
        "name": "eric",
        "email": "",
        "countryCode": "86",
        "phone": "13800138001",
        "createTime": 1532526039883,
        "createIp": "::ffff:123.59.101.208",
        "ssid": {},
        "icon": "default.jpg",
        "spaceUsed": 0,
        "spaceCapacity": 8192,
        "type": 0,
        "status": 0
    },
    "code": "OK",
    "success": true,
    "token": "..."
}

如果验证码无效:

{
    "success": false,
    "message": "Code not valid",
    "code": "{CODE}_NOT_VALID",
    "status": 400
}

肯能出现的错误

错误码(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 验证码无效