Refresh AccessToken

Sandbox

https://openapi-stage-hk.orangeconnex.com

POST

/oauth/token

OAuth

3PP obtains a new access token by refresh token.
When the access token expires, 3PP can obtain a new access token by refresh token.

Request

Query Params

client_id

string

required

The ID of 3PP offered by OC offline

grant_type

string

required

Fixed value "refresh_token"

refresh_token

string

required

The refresh token is from the response of "get accessToken&refreshToken" API

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi-stage-hk.orangeconnex.com/oauth/token?client_id=&grant_type=&refresh_token='

Responses

🟢200OK

application/json

Body

access_token

string

optional

Value of access token. When 3PP requests APIs (exclude "getServiceList" API), access token should be contained in a header named "Access-Token".

error

string

optional

error_description

string

optional

expires_in

integer <int32>

optional

Duration of validity of access token.

refresh_token

string

optional

Value of refresh token. If the access token is expired, 3PP uses the refresh token to get a new access token and its expiration date.

token_type

string

optional

Fixed value: "bearer"

Example

{
  "access_token": "string",
  "error": "string",
  "error_description": "string",
  "expires_in": 0,
  "refresh_token": "string",
  "token_type": "string"
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

AccessToken

SKUCreation v3