登录接口文档 - MOMpro平台文档

# MOMpro 登录接口token

## 接口描述
MOMpro 登录接口
目前支持密码登录，短信验证码登录，扫描工牌登录
通过不同的`grant_type`来区分登录方式，分别为`password` `sms_code` `scan_qr_code`
由于目前MOMpro浏览器端和kanban端以及app端目前前端没有实现滑动验证码，因此这三种登录方式需额外传入`type`参数，传入值分别为`MOMproBrowser`,`kanban`,`app`。后台会根据`type`值来判断是否需要验证。
通过WEB端登录时，当后台提示需要验证时，需要调用获取滑动验证模块接口，获取滑动验证模块，然后调用滑动验证接口，验证通过后，将返回的`captchaId`传入登录接口

## 请求URL

POST /orbit/security/oauth/token

## 请求参数说明

|名称|位置|类型|必需|描述|
|---|---|---|---|---|
|body|body|object| yes |none|
|» client_id|body|string| yes |客户端Id|
|» client_secret|body|string| yes |客户端secret|
|» grant_type|body|string| yes |授权类型：password, sms_code, scan_qr_code|
|» username|body|string| no |用户Code|
|» password|body|string| no |密码|
|» phone|body|string| no |手机号|
|» code|body|string| no |手机验证码 或 工牌二维码数据|
|» type|body|string| no |登录类型：MOMproBrowser,kanban,app 目前登录类型为kanban,app,MOMproBrowser时，不需要验证码，其他需要验证码|
|» captchaId|body|string| no |验证码id|

## 密码方式登录

> 请求参数示例

```yaml
client_id: c1
client_secret: secret
grant_type: password
username: orbit
password: orbit202
type: kanban
captchaId: 5a8b76d7-3f14-472f-925d-b9af8e952720

```

## 短信验证码登录

> 请求参数示例
手机验证码的登录方式，需要先调用发送验证码接口，然后再调用登录接口
因此新环境的验证校验，需要在发送验证码接口中进行，此处不需要传入验证码id（captchaId）

```yaml
client_id: c1
client_secret: secret
grant_type: sms_code
phone: 13888888888
code: 123456
type: kanban

```

## 扫描工牌登录

> 请求参数示例

```yaml
client_id: c1
client_secret: secret
grant_type: scan_qr_code
code: lkjahdj
type: kanban
cptchaId: 5a8b76d7-3f14-472f-925d-b9af8e952720

```

> 响应体示例

> 成功

```json
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0ZW5hbnRfaWQiOm51bGwsInVzZXJfbmFtZSI6Im9yYml0Iiwic2NvcGUiOlsiYWxsIl0sImNsaWVudElwIjoiMTkyLjE2OC4xLjIzMyIsImV4cCI6MTcwNzk2NjMyOSwiYXV0aG9yaXRpZXMiOlsiYWRtaW4iXSwianRpIjoiZmFjMzkwNTgtMjM4MS00MjU5LWJjZDAtYjBjZjAzODlhZTYyIiwiY2xpZW50X2lkIjoiYzEifQ.xkCWbb6_nGyN62wruaLqCXQ8yyEDhyoVmKUwlJKO34c",
  "token_type": "bearer",
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0ZW5hbnRfaWQiOm51bGwsInVzZXJfbmFtZSI6Im9yYml0Iiwic2NvcGUiOlsiYWxsIl0sImF0aSI6ImZhYzM5MDU4LTIzODEtNDI1OS1iY2QwLWIwY2YwMzg5YWU2MiIsImNsaWVudElwIjoiMTkyLjE2OC4xLjIzMyIsImV4cCI6MTcxMDAzOTkyOSwiYXV0aG9yaXRpZXMiOlsiYWRtaW4iXSwianRpIjoiYjViMGMyYWMtMTI2ZC00NWE1LThkZTEtYWI5YTk5MGYxNTZjIiwiY2xpZW50X2lkIjoiYzEifQ.YNb6608PfBF9ak7RfNrrSTMZE-9_NJ2aiuGkJeNX1N4",
  "expires_in": 2073599,
  "scope": "all",
  "jti": "fac39058-2381-4259-bcd0-b0cf0389ae62"
}
```
> 失败

```json
{
  "code": 1001,
  "message": "用户名或密码错误",
  "data": null
}
```

```json
{
  "code": 1114,
  "message": "新环境登录，请进行验证",
  "data": null
}
```

```json
{
  "code": 1113,
  "message": "登录失败次数过多，请进行验证",
  "data": null
}
```

```json
{
  "code": 1112,
  "message": "账号已锁定，请在1分39秒后再登录，或者联系管理员解锁",
  "data": null
}
```