# 用户登录 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"
}
上次更新: 2023/11/16 上午11:17:30