简要描述:
- token过期重新刷新
接口版本:
版本号 | 制定人 | 制定日期 | 修订日期 |
---|---|---|---|
v3 | 陈碧贵 | 2019-01-20 | xxxx-xx-xx |
请求URL:
http://{url参数} /bo/api/v3/auth/token/refresh?refreshToken=MtP0zZx1gZE66xDnhwd1UV973XoVL4nT
http://localhost:58582/bo/api/v3/auth/token/refresh?refreshToken=MtP0zZx1gZE66xDnhwd1UV973XoVL4nT
请求方式:
- GET
请求头:
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
XownerId | 是 | string | 项目唯一ID,对应bo_project {ownerId} |
XsysId | 否 | string | 所属系统 对应 bo_system 表 |
XuserFromFirstShareId | string | 否 | 一级分享用户ID, bo_user user_id |
XuserFromSecondShareId | string | 否 | 二级分享用户ID, bo_user user_id |
XverifyApi | 是 | string | 加密规则encryptByDES(`${newGuid()} |
XfilterAreaCode | 否 | string | 行政区编码, 对应 bo_sys_area area_code |
Content-Type: | 是 | string | application/json; charset=utf-8 请求类型 |
请求参数:
- 当事件发生时,调用http/https接口,传递参数信息,响应请求结果。
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
refreshToken | 是 | string | 用来刷新的key,通过登录时候获取MtP0zZx1gZE66xDnhwd1UV973XoVL4nT |
_nodejs | 是 | string | common-data 对应/Config/AppNodeJs/Plugins/fn- common-data.js, 通过nodejs插件,对响应结果进行二次处理 common-data 普通数据(小写驼峰)common-data-under 普通数据下划线 |
返回示例:
正确时返回:
{
“success”:true,
“data”:{
{
"tokenType": "Bearer",
"tokenUser": {
"clientId": "ptdev",
"userId": "ptdev",
"userName": "dev",
"pushName": "开发管理员",
"roleId": ["development"],
"depId": [],
"areaCode": [],
"jobId": [],
"sysId": [],
"mergeUserId": [],
"developer": 1
},
"timeStamp": 1614246960367.5437,
"refreshToken": "MtP0zZx1gZE66xDnhwd1UV973XoVL4nT",
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJSRzMiLCJhdWQiOiJhcGkiLCJpZCI6InB0ZGV2IiwibmFtZSI6ImRldiIsImNsaWVudF9pZCI6InB0ZGV2IiwiZXhwaXJlcyI6IjIwMjEvMi8yNSAxODoyMjozNyIsIm9wZW5faWQiOiIiLCJ3Yl9pZCI6IiIsInd4X29wZW5faWQiOiIiLCJ3eF91bmlvbl9pZCI6IiIsInRlbGVwaG9uZSI6IiIsInB1c2hfbmFtZSI6IuW8gOWPkeeuoeeQhuWRmCIsImhlYWRfaWNvbiI6IiIsImRlcF9pZCI6IiIsInN5c19pZCI6IiIsIm1lcmdlX3VzZXJfaWQiOiIiLCJhcmVhX2NvZGUiOiIiLCJyb2xlX2lkIjoiZGV2ZWxvcG1lbnQiLCJkZXZlbG9wZXIiOiIxIiwibmJmIjoxNjE0MjQ4NDk3LCJleHAiOjE2MTQyNDg1NTcsImlhdCI6MTYxNDI0ODQ5N30.XL2xjJ_idNHpUuppLG2JuVQ0DfyMRv5-gyg2H32dB0A",
"clientId": "ptdev",
"expires": "2021-03-11T17:56:00",
"expiresIn": 1614246960368
}
}
}
错误时返回:
{
"code": 0,
"message": ""
"error":{
errorCode:null,
errorText:null
}
"success": false,
}
返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
success | bool | true 表示数据请求成功(跟code=0一致),调用者优先使用 |
code | int | true 表示数据请求成功(跟code=0一致),调用者优先使用 |
data | object | 获取到的数数据,重写赋予token loginAuth.saveAuth({}, user, token) |
expiresIn | 单位秒,表示客户端多少秒后token过期,前端需要重新调用刷新接口 | |
expires | 服务端绝对过期时间,服务端使用 | |
accessToken | 存储用户信息的访问token | |
cacheType | string | redis/sqlite/local 数据来源缓存 的类型(便于开发调试和性能优化) |
cacheDate | date | 最后数据获取时间 |
文档更新时间: 2022-05-20 05:55 作者:admin