Refresh Access Token¶
Refresh the generated access token before it expires (the expiring time of the access token is 2 hours by default).
Request Format¶
POST https://{apigw-address}/apim-token-service/v2.0/token/refresh
Request Parameters (Body)¶
Name |
Required or Not |
Data Type |
Description |
---|---|---|---|
appKey |
True |
String |
The access key of the application |
encryption |
True |
String |
Encrypted ciphertext. See Encryption Generation Rule >> |
timestamp |
True |
Long |
Time stamp of the current system time (UNIX time, accurate to milliseconds), e.g. 1572574909697 |
accessToken |
True |
String |
The access token to be refreshed |
Response Parameters¶
Name |
Data Type |
Descritpion |
---|---|---|
status |
Integer |
API request status code, with 0 indicating successful request |
msg |
String |
Explanation of the status codes |
business |
String |
Business parameter, with the value of apim-token-service |
data |
Data Struct |
Refreshed access token and its expiring time |
Data Struct¶
Name |
Data Type |
Description |
---|---|---|
accessToken |
String |
The refreshed access token |
expire |
Integer |
Expiring time of the access token in seconds, with an initial value of 7,200 (i.e. 2 hours). |
Sample¶
Request Sample¶
POST
https://{apigw-address}/apim-token-service/v2.0/token/refresh
{
"appKey": "5acb82e7-a11e-4300-9164-c8b20b638e8b",
"encryption": "87c6885cec7525e2f219f86a82b280cc8c2d6ff4040a4b5f8acf9aeeda37aba8",
"accessToken":"adsfwerasdfsdfasggaaf",
"timestamp": 1572574909697
}
Return Sample¶
{
"status": 0,
"msg": "SUCCESS",
"business": "apim-token-service",
"data": {
"accessToken": "Refreshed_Access_Token",
"expire": 7200
}
}