# 用户登录接口

  • 接口说明: 用户登录接口
  • 接口地址: /api/login
  • 请求方式: POST

# 请求参数

参数名称 类型 是否须 描述
username string 用户名/手机号(支持手机号+密码的形式登陆)
password string 密码
token string [微信公众号通过code参数换取token接口](wechat-user.html)返回的 token,用于登陆并绑定微信
js_code string 小程序用户名密码登录时传入,会绑定小程序用户信息。 微信小程序登陆code,https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/wx.login.html
iv string 小程序用户名密码登录时传入,会绑定小程序用户信息。 微信小程序用户数据数据加密算法的初始向量,https://developers.weixin.qq.com/miniprogram/dev/api/open-api/user-info/wx.getUserInfo.html
encryptedData string 小程序用户名密码登录时传入,会绑定小程序用户信息。 微信小程序用户包括敏感数据在内的完整用户信息的加密数据,https://developers.weixin.qq.com/miniprogram/dev/api/open-api/user-info/wx.getUserInfo.html
mobileToken string 手机号登录时未绑定用户返回的token,用于登陆并绑定手机号 [短信验证](sms-verify.html)
rebind int 重新绑定当前微信。 换绑:1,不换:0或者不传

# 请求示例

{
  "data": {
    "attributes": {
      "username": "username",
      "password": "password"
    }
  }
}

# 返回结果

参数名称 类型 出现要求 描述
token_type string 登录成功 token 类型
expires_in int 登录成功 时间
access_token token 登录成功 用户标识
refresh_token token 登录成功 刷新用户标识

# 返回说明

  • 登录成功, http 状态码: 200
  • 登录失败, http 状态码: 400

# 返回示例

{
  "data": {
    "type": "token",
    "id": "1",
    "attributes": {
      "token_type": "Bearer",
      "expires_in": 2592000,
      "access_token": "eyJ0eXAiOiJKV1Qi......dj3H9CCSPib6MQtnaT6VNrw",
      "refresh_token": "def50200a26b6a9......10ccbf3c1694084c2d2d276"
    }
  }
}

# 失败示例

{
  "error": "invalid_grant",
  "error_description": "The provided authorization grant (e.g., authorization code, resource owner credentials) or refresh token is invalid, expired, revoked, does not match the redirection URI used in the authorization request, or was issued to another client.",
  "hint": "",
  "message": "The provided authorization grant (e.g., authorization code, resource owner credentials) or refresh token is invalid, expired, revoked, does not match the redirection URI used in the authorization request, or was issued to another client."
}