ecologyDoc/core/Token使用文档.md

Token使用流程概述

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

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

• 备用加密工具1
• 备用加密工具2

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"
}