使用用户名/手机号登录
- 路径:
/v2/user/login
- 方法:
POST
- 登录: 不需要
需要提交的字段
字段 | 类型 | 默认值 | 必填 | 说明 | 备注 |
---|---|---|---|---|---|
name | string | 是 | 用户昵称 | 与 countryCode + phone组合 二选一 | |
countryCode | string | 86 | 默认 | 区号 | 用户国家码 |
phone | string | 是 | 用户电话号码 | 与name 二选一 | |
password | string | 是 | 密码MD5 | 用户输入密码经过MD5以后的小写值 |
或者不区分 使用用户名还是手机, 由系统自动区分
字段 | 类型 | 默认值 | 必填 | 说明 | 备注 |
---|---|---|---|---|---|
value | string | 是 | 用户昵称 或者电话号码 | 纯数字时候认为是手机登录,否则认为是用户名 | |
countryCode | string | 86 | 默认 | 区号 | 用户国家码 |
password | string | 是 | 密码MD5 | 用户输入密码经过MD5以后的小写值 |
返回
- 标准返回 (User) 参见 实体说明-标准返回 和 实体说明-User
注意事项
在
name
和phone
字段同时存在的情况下,视为使用用户名登录。countryCode
在未指定的情况下,默认为86(中国大陆)password
必须为MD5加密之后的小写字符串
示范
- 发送
POST
/v2/user/login
{
"phone":"15124513721",
"password":"48cf7a2041170977c2ca6e7d7757bc33"
}
或者
{
"value":"15124513721",
"password":"48cf7a2041170977c2ca6e7d7757bc33"
}
- 接收:
{
"status": 0,
"result": {
"identity": 1,
"name": "admin",
"countryCode": "86",
"phone": "151****3721",
"email": "",
"createTime": 1532526039883,
"createIP": "::ffff:123.59****.208",
"icon": "default.jpg",
"spaceUsed": 285025314667,
"spaceCapacity": 6597069766656,
"ignoreCase": false,
"type": 0,
"status": 1,
"version": 0,
"ssid": "5_nplTG0os"
},
"code": "OK",
"success": true
}
- 头信息:
Server →nginx/1.12.2
Date →Sat, 13 Apr 2019 16:10:56 GMT
Content-Type →application/json; charset=utf-8
Content-Length →339
Connection →keep-alive
x-powered-by →Express
access-control-allow-origin →*
access-control-expose-headers →Qingzhen-Token
qingzhen-token →eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZGVudGl0eSI6NSwiaWdub3JlQ2FzZSI6ZmFsc2UsInNzaWQiOiI1X2YwQXV3bXZUIiwic3RhdHVzIjowLCJ2ZXJzaW9uIjoyLCJpYXQiOjE1NTUxNzE4NTYsImV4cCI6MTU1Nzc2Mzg1Nn0.xAdaxW6r7rARNSimWsLE6aEIpUsNbYQZQ9FQlC_DH6E
etag →W/"153-rcacXTN5WO53OQmxBYKjBxdLM4s"
x-envoy-upstream-service-time →171
保留
qingzhen-token
头,以便下次访问时候提供。当
qingzhen-token
头为空,请删除本地缓存的token信息。