ecologyDoc/core/Token使用文档.md

Token使用流程概述

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

getVirtualToken 获取token

请求方式 POST http://172.20.109.105:7007/core/auth/getVirtualToken
数据格式 Json

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

返回参数	类型	是否比返	说明
errcode	Num	是	0交易成功 其它为异常情况
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
数据格式 Json

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

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

请求示例

{
    "refreshToken":""
}

返回示例

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