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: string
Required: true

This element provides access to the resource and expires after 15 minutes.

appLinkID
Type: string
Required: true

This element uniquely identifies the resource.

refreshToken
Type: string
Required: true

This 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.
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"
}