刷新鉴权Token

更新时间：2022-04-28 16:46:01

接口描述

该接口专门供OAuth2.0鉴权方式用，采用请求签名鉴权方式时无需调用此接口。

详见OAuth2.0鉴权方式调用接口说明

使用refresh token刷新授权码，在授权码过期前，通过refresh token获取新的授权码，旧授权码Token可以与新授权码Token共存5分钟，5分钟后旧授权码Token失效。

e签宝服务端允许开发者多次调用“获取鉴权Token”接口获取授权码Token。但只有最新获取的授权码Token的有效时长为120分钟。

举例：

连续获取100个授权码Token（T1，T2，……，T99，T100），此时T1-T98个Token属于失效Token无权调用接口。而T99个Token有效时长为5分钟，T100个Token有效时长为120分钟。

如果开发者同时有多台服务器调用api接口，建议使用集中存储方式保存授权码Token以确保授权码Token值的唯一。

接口

/v1/oauth2/refresh_token

请求方式

GET

请求参数

参数名称	类型	必选	参数类型	参数说明	示例值
appId	string	是	query	应用id，需在e签宝开放平台创建
refreshToken	string	是	query	用于刷新授权码的token
grantType	string	是	query	授权类型，固定值: refresh_token

响应参数

展开全部参数参数名称		类型	必选	参数说明	示例值
code		int	是	业务码，0表示成功
message		string	否	信息
data		object	否	业务信息
	token	string	否	授权码
	expiresIn	string	否	有效截止时间（毫秒）
	refreshToken	string	否	刷新授权码, 授权码token即将过期时需要用该刷新授权码获取新的token.

请求示例

GET https://smlopenapi.esign.cn/v1/oauth2/refresh_token?appId=4438771809&refreshToken=d1feeb03c7a635f11032d8f906e83b46&grantType=refresh_token

Postman请求示例

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "expiresIn": "1569212685506",
        "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJnSWQiOiI4N2I4YmJhNGY2N2U0ZjRiODQ3Njc2M2FmNTRjZGYxYSIsImFwcElkIjoiNDQzODc3MTgwOSIsIm9JZCI6ImJiZDNlYTExZWY0ZDQyNmI4NTYzNDhmYjg1MDYxM2ZmIiwidGltZXN0YW1wIjoxNTY5MjA1NDg1NTA1fQ.pVUxWk7VskA6vo5ePQ1YWsIxLZh95xt57AvMoRbnaYs",
        "refreshToken": "4db9a6c275a089ae04315631d177aa8a"
    }
}

错误码

错误码	错误描述	解决方案
72000009	refresh_token错误	refresh_token应取获取鉴权Token接口返回的refreshToken值