Skip to Content

Refresh Access Token

Access token expires after 30 minutes. To ensure communication between PBX and third-party application, you need to call this interface to update the access token.

Request URL

POST {base_url}/{api_path}/refresh_token

Request Parameters

ParameterRequiredTypeDescription
refresh_tokenYesStringThe latest refresh_token value.

Response Parameters

ParameterTypeDescription
errcodeIntegerReturned error code.
  • 0: Succeed.
  • Non-zero value: Failed.
Note:You can check the error code and error message in Error Code and Error Message.
errmsgStringReturned message.
  • SUCCESS: Succeed.
  • FAILURE: Failed.
access_token_expire_timeIntegerAccess token expire time. (Unit: second)
access_tokenStringNew access token.
refresh_token_expire_timeIntegerRefresh token expire time. (Unit: second)
refresh_tokenStringNew refresh token.

Examples

Request example

POST /openapi/v1.0/refresh_token
Host: 192.168.5.150:8088
Content-Type: application/json

{
	"refresh_token": "SCduGecwbG9jIusiS8FxFUVn3kf0Q9R8"
}

Response example

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "access_token_expire_time": 1800,
    "access_token": "4JkX5GQObeL9MGcPZDN4o4Ecv114Jo1e",
    "refresh_token_expire_time": 86400,
    "refresh_token": "fTyEpc1OTDU2vckJauWL6uBRasYYpbKU"
}