刷新 Access Token¶
Access Token不是永久有效的,默认有效时间为2个小时,即7200秒。Access Token失效前,需要刷新Access Token。
请求方式¶
POST https://{apigw-address}/apim-token-service/v2.0/token/refresh
请求参数(Body)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
appKey |
必需 |
String |
应用的AccessKey。 |
encryption |
必需 |
String |
加密密文,参考 加密密文生成规则>> |
timestamp |
必需 |
Long |
当前系统的时间戳,UNIX时间,精确到毫秒,例如:1572574909697。 |
accessToken |
必需 |
String |
待刷新的Access Token。 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
status |
Integer |
状态码,0表示成功。 |
msg |
String |
提示信息。 |
business |
String |
业务参数,为固定值:apim-token-service。 |
data |
data结构体 |
刷新后的Access Token及有效时间。 |
data结构体¶
名称 |
数据类型 |
描述 |
---|---|---|
accessToken |
String |
刷新后的Access Token。 |
expire |
Integer |
Access Token的过期时间,单位为秒,初始值为7200秒(即2小时)。 |
示例¶
请求示例¶
url: https://{apigw-address}/apim-token-service/v2.0/token/refresh
method: POST
requestBody:
{
"appKey": "5acb82e7-a11e-4300-9164-c8b20b638e8b",
"encryption": "87c6885cec7525e2f219f86a82b280cc8c2d6ff4040a4b5f8acf9aeeda37aba8",
"accessToken": "adsfwerasdfsdfasggaaf",
"timestamp": 1572574909697
}
响应示例¶
{
"status": 0,
"msg": "SUCCESS",
"business": "apim-token-service",
"data": {
"accessToken": "Refreshed_Access_Token",
"expire": 7200
}
}