# 用户登录 API
用户登录,使用 POST
发起请求,请求地址为 /api/v1/users/actions/login
,此接口可以直接访问,无需身份验证。
POST /api/v1/users/actions/login
# 请求 Body
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
account | 字符串 | 否 | 用户账号,可以是用户名、邮箱或者手机号 |
password | 字符串 | 否 | 用户密码,需要 MD5 加密后传输 |
openId | 字符串 | 否 | 微信用户的标识,对当前公众号唯一 |
请求 Body 可以通过传递 account
以及 password
进行登录,也可以只传递 openId
值进行登录。
# 返回
名称 | 类型 | 说明 |
---|---|---|
200 OK | User,AccessToken | 用户,用户登录 Token |
401 Unauthorized | Error | 认证错误 |
400 BadRequest | Error | 参数错误 |
# 示例
# 通过账号密码登录
POST /api/v1/users/actions/login
Content-Type: application/json
{
"account": "demo",
"password": "7d683abba984a7804078471700c39fb9"
}
# 通过OpenId登录
POST /api/v1/users/actions/login
Content-Type: application/json
{
"openId": "7daz3Kk1n6h4B9MZotWAyHn7Z5ueOcghZXbIqselJGxqikdLL7vv2ZCTBfc81CM2"
}
# 返回示例
{
"user": {
"id": 1,
"userName": "demo",
"password": "3CPlhZ8UAus=",
"passwordFormat": "Encrypted",
"createDate": "2018-06-17 14:18:45",
"lastResetPasswordDate": "2018-06-17 14:18:45",
"lastActivityDate": "2018-06-17 14:18:45",
"countOfLogin": 0,
"countOfFailedLogin": 0,
"countOfWriting": 0,
"checked": true,
"locked": false,
"displayName": "用户名",
"email": "demo@sample.com",
"mobile": "13888888888",
"avatarUrl": "",
"openId": ""
},
"accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJVc2VyTmFtZSI6ImRlbW8iLCJBZGREYXRlIjoiXC9EYXRlKDE1MjkzNjc0NzQxNjUpXC8ifQ.1Ka9OgcwEseeo2igDuPxdk_H7Mb1trzOxEVwj_VEJZc"
}
← 获取用户列表 API 用户退出登录 API →