Refresh Applink Token
put
/documents/api/1.1/applinks/token
Refresh an expired access token.
Request
Supported Media Types
- application/json
- application/xml
Header Parameters
- accessToken
-
Type:
stringRequired:trueThis element provides access to the resource and expires after 15 minutes.
- appLinkID
-
Type:
stringRequired:trueThis element uniquely identifies the resource.
- refreshToken
-
Type:
stringRequired:trueThis element enables you to request a new access token when the current access token expires. The refreshed token expires after 24 hours.
Response
Supported Media Types
- application/json
- application/xml
200 Response
The response body includes the refreshed access token.
Body
The response body includes a refreshed access token.
Root Schema : ApplinkTokenResponse
The response body includes a refreshed access token.
- accessToken
-
Type:
stringThis element provides access to the resource and expires after 15 minutes. You can refresh the access token any number of times within the time period defined by the refreshed token (24 hours). - errorCode
-
Type:
stringAn error code of zero (0) indicates no errors. - type
-
Type:
stringItem typeapplink.
Example application/json
{
"accessToken":"GYrSN5zuj0kOTE4k_60bKvdkxx2-ARA546A2T77GtEOgoPZPGgKk126OeCn1w-Ij",
"type":"applink",
"errorCode":"0"
}
400 Response
Request parameters are not formatted correctly.
Examples
The following example requests a new access token.
PUT .../applinks/token
Request Header
The request parameters for the Refresh Applink Token call are supplied in the header of the call rather than in a conventional request. For example, the header parameters are similar to the following ones:
AppLinkID: LFwi1u1E9vZC_3pQhK5C4qxigAC4o1eUuMnv3dZbo6_OiaZx-yte-xIrxWdDJCA_jEgfVHe1At-26KX-M9mi9BaI7B0UX3Gx-QufREHWcHakby0_V9n8_C1pT7P_CKYlSqFU0rudQ8Q81M67-3fLffMA== AccessToken: _qVnD42Et8KwZrBUqveiqn1sw-RLpfZQdIPPi_fd17-gt60FP6-IuCApyLFw32EL RefreshToken: ctOCKm4mtpayp__jUlQsfdFEd52vSn2Pd4QxOTcSZ1Wch0f9JP7EFSaXmDLKZdql
Request Body
None.
HTTP Status Code
HTTP_STATUS = 200
JSON Response
{
"accessToken": "RgzsGZPf6EwPj7SNasFkNiOZ3J7nESOxL2YMkRXuJ_Hg_1elUdhaP7l2Y7MVY0L_",
"errorCode": "0",
"type": "applink"
}