Refresh AccessToken

Sandbox

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

POST

/oauth/token

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

Example:

bd1d1971-d0db-11ea-b4a1-00505694c27b

grant_type

string

required

Fixed value "refresh_token"

Example:

refresh_token

string

required

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

Example:

eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NjE4OTgxNTEsInVzZXJfbmFtZSI6IjEwOTA4NzExIiwiY2xpZW50X2lkIjoiYmQxZDE5NzEtZDBkYi0xMWVhLWI0YTEtMDA1MDU2OTRjMjdiIiwic2NvcGUiOlsiYWxsIl19.xMRDWo0tSvupZ9a4qz5xJuzmM5bxwh3Ape3ifetE3WFrFPtRSrB9OpkPoJymxVgU4vM0-Crkq8xfWS8FlGmsm3nPI2LXKZZWXMlGLcHBJayJl_IU6Dpqh20G5PSo4CTdczEtA5FOtYw7xJ8PlPXgQ5b_thJRzQv48ywNF4HykUZMemkfpProO-Dj6u0VZyvspzF1nBjUDIyYeBWXDIBaoM0JvZGJpds4HOxRxx6AETqC_iUTeieeUL89YnOfTgZDJT1pNwexGiEv2nylzrqfxVRJrzs2qQ6qWpn5AtjAncEnJ1OdU8jI7_7jfPFaEop6ci0PbPT2fSM9AQsR96jE0WhmUJnapP9BxP6oNztjLzj2i2LH9ndTry3JJkUUeoBu_97Eu9StzsweciXPHKIIOwF2ZzXpZ_U91mD9QJlozqEoRmWeMNgjba7jeI_cIgJYB4JFnbIk3DapgB_OLtUEnzndseJ3G-vMQvAKpRgHbcQR2m7O1r0HYw0KxfE3-tpYTksO6__Si-BpDRcG3ApKfbwn1THBMXdJyZW6B4ljGYRySgdOCTjMCNT4jgLp8-ah7XEfpdUAYjgcpjdYSyXzvq31bJRTUru9QCrmVP8AC06KhufxRPwvPAJhySTHTDgBdDaDYA28iDLbkeVqbnk9MmE-O35KBYDrlpDKx-mIzaU

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=bd1d1971-d0db-11ea-b4a1-00505694c27b&grant_type=refresh_token&refresh_token=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NjE4OTgxNTEsInVzZXJfbmFtZSI6IjEwOTA4NzExIiwiY2xpZW50X2lkIjoiYmQxZDE5NzEtZDBkYi0xMWVhLWI0YTEtMDA1MDU2OTRjMjdiIiwic2NvcGUiOlsiYWxsIl19.xMRDWo0tSvupZ9a4qz5xJuzmM5bxwh3Ape3ifetE3WFrFPtRSrB9OpkPoJymxVgU4vM0-Crkq8xfWS8FlGmsm3nPI2LXKZZWXMlGLcHBJayJl_IU6Dpqh20G5PSo4CTdczEtA5FOtYw7xJ8PlPXgQ5b_thJRzQv48ywNF4HykUZMemkfpProO-Dj6u0VZyvspzF1nBjUDIyYeBWXDIBaoM0JvZGJpds4HOxRxx6AETqC_iUTeieeUL89YnOfTgZDJT1pNwexGiEv2nylzrqfxVRJrzs2qQ6qWpn5AtjAncEnJ1OdU8jI7_7jfPFaEop6ci0PbPT2fSM9AQsR96jE0WhmUJnapP9BxP6oNztjLzj2i2LH9ndTry3JJkUUeoBu_97Eu9StzsweciXPHKIIOwF2ZzXpZ_U91mD9QJlozqEoRmWeMNgjba7jeI_cIgJYB4JFnbIk3DapgB_OLtUEnzndseJ3G-vMQvAKpRgHbcQR2m7O1r0HYw0KxfE3-tpYTksO6__Si-BpDRcG3ApKfbwn1THBMXdJyZW6B4ljGYRySgdOCTjMCNT4jgLp8-ah7XEfpdUAYjgcpjdYSyXzvq31bJRTUru9QCrmVP8AC06KhufxRPwvPAJhySTHTDgBdDaDYA28iDLbkeVqbnk9MmE-O35KBYDrlpDKx-mIzaU'

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"

Examples

ExceptionSuccess

{
    "error": "invalid_grant",
    "error_description": "Invalid refresh token: eyJhbGciOiJSUzI1NiIsInRcC6IkpXVCJ9.eyJleHAiOjE3NjE4OTgxNTEsInVzZXJfbmFtZSI6IjEwOTA4NzExIiwiY2xpZW50X2lkIjoiYmQxZDE5NzEtZDBkYi0xMWVhLWI0YTEtMDA1MDU2OTRjMjdiIiwic2NvcGUiOlsiYWxsIl19.xMRDWo0tSvupZ9a4qz5xJuzmM5bxwh3Ape3ifetE3WFrFPtRSrB9OpkPoJymxVgU4vM0-Crkq8xfWS8FlGmsm3nPI2LXKZZWXMlGLcHBJayJl_IU6Dpqh20G5PSo4CTdczEtA5FOtYw7xJ8PlPXgQ5b_thJRzQv48ywNF4HykUZMemkfpProO-Dj6u0VZyvspzF1nBjUDIyYeBWXDIBaoM0JvZGJpds4HOxRxx6AETqC_iUTeieeUL89YnOfTgZDJT1pNwexGiEv2nylzrqfxVRJrzs2qQ6qWpn5AtjAncEnJ1OdU8jI7_7jfPFaEop6ci0PbPT2fSM9AQsR96jE0WhmUJnapP9BxP6oNztjLzj2i2LH9ndTry3JJkUUeoBu_97Eu9StzsweciXPHKIIOwF2ZzXpZ_U91mD9QJlozqEoRmWeMNgjba7jeI_cIgJYB4JFnbIk3DapgB_OLtUEnzndseJ3G-vMQvAKpRgHbcQR2m7O1r0HYw0KxfE3-tpYTksO6__Si-BpDRcG3ApKfbwn1THBMXdJyZW6B4ljGYRySgdOCTjMCNT4jgLp8-ah7XEfpdUAYjgcpjdYSyXzvq31bJRTUru9QCrmVP8AC06KhufxRPwvPAJhySTHTDgBdDaDYA28iDLbkeVqbnk9MmE-O35KBYDrlpDKx-mIzaU"
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Modified at 2025-06-18 08:29:09

AccessToken

SKUCreation v3