使用短信登录
发送登录验证码
- 验证码有效期为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 | 验证码无效 |