ecologyDoc/core/Token使用文档.md

### Token使用流程概述
1. 向生态系统申请系统名、用户名、密码
2. 使用 `getVirtualToken` 接口请求 token 
3. 将 `token` 作为请求头 `Authorization` 的值，即可正常调用其他接口
4. `token` 15 分钟失效，建议`token`超过10分钟时，使用 `getVirtualToken` 接口重新获取

```diff
注：
    1.向生态系统申请系统名/用户名/密码等参数需提供法人名称、机构编号
    2.涉及APP应用需提供IOS及Android包名
    3.提供对接过程中使用的AI能力列表（用于权限配置）
``` 

* *备用[加密工具1](https://the-x.cn/zh-cn/cryptography/Rsa.aspx)*
* *备用[加密工具2](https://www.bejson.com/enc/rsa/)*


![Token](./image/token.png)

### getVirtualToken 获取token
> 请求方式  ` POST http://172.20.109.105:7007/core/auth/getVirtualToken` <br>
> 数据格式 `Json`

| 请求参数  | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- | 
| sysName | String| 是 | 系统名称 |
| userCode | String | 是 | 用户名 |
| password | String | 是 | 密码 |

| 返回参数  | | 类型 | 是否必返 | 说明 |
| --- | --- |--- | --- | --- | 
| errcode || Num| 是 | 0交易成功<br>其它为异常情况 |
| errmsg || String | 否 | errcode不为0时有值 |
| data || - | - | - |
| |accessToken | String | 是 | 获取到的Token |
| |refreshToken | String | 是 | 用于刷新Token的 |

请求示例

```
{
    "sysName":"",
    "userCode":"",
    "password":""
}
```

返回示例

```
{
    "errcode":0,
    "data":{
        "accessToken":"",
        "refreshToken:""
    },
    "errmsg":"SUCCESS"
}
```

### ~~refreshToken 获取token~~
> 请求方式  ` POST http://172.20.109.105:7007/core/auth/refreshToken` <br> 
> 数据格式 `Json`

| 请求参数  | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- | 
| refreshToken | String| 是 | 获取Token时返回的refreshToken |

| 返回参数 | | 类型 | 是否必返 | 说明 |
| --- | --- | --- | --- | --- |
| errcode || Num| 是 | 0交易成功<br>其它为异常情况 |
| errmsg || String | 否 | errcode不为0时有值 |
| data || - | - | 包含数据见下 |
| |accessToken | String | 是 | 获取到的Token |

请求示例

```
{
    "refreshToken":""
}
```

返回示例

```
{
    "errcode":0,
    "data":{
        "accessToken":""
    },
    "errmsg":"SUCCESS"
}
```