接口描述
使用refresh token刷新授权码,在授权码过期前,通过refresh token获取新的授权码,新旧token会共存5分钟。
接口
/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值 |