Query Callback Authentication Token
Feature Overview
App administrators can query callback authentication token through this interface. For detailed usage of Token, see Security Considerations.
API Calling Description
Sample request URL
https://xxxxxx/v4/live_config/get_callback_token?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
Request parameters
The table below only lists the parameters modified when calling this API and their description. For more information, please refer to RESTful API Overview.
Parameter | Description |
xxxxxxx | The reserved domain for the country/region where the SDKAppID is located: China: console.tim.qq.comSingapore : adminapisgp.im.qcloud.comAmerica : adminapiusa.im.qcloud.com |
v4/livee_config/get_callback_token | Request API |
sdkappid | SDKAppID assigned by the Chat console when an app is created |
identifier | |
usersig | |
random | A random 32-bit unsigned integer ranging from 0 to 4294967295 |
contenttype | The request format fixed value is json |
Maximum calling frequency
200 queries/sec.
Sample request packets
Basic form
{}
Request packet fields
Sample response packets
Basic Form
{"ErrorCode": 0,"ErrorInfo": "","ActionStatus": "OK","RequestId": "Id-59876bec05e648efbd5bb9373bdecbc1-O-Seq-1424636","Response": {"Token": "kdjsgjdskgjwejsdkkjgkjfklgjdfkjhnkdfhjgkglasdjkfjsekdhgjfsdhgsdjgkdjskgjfhjdfkjgsfdkjgeljsfkjsdkgdfkhgdfjgksdjfsdkjfksdgskhgssss","IsTokenEnable": true}}
Response Packet Field Description
Field | Type | Description |
ActionStatus | String | The result of the request process: OK indicates success; FAIL indicates failure |
ErrorCode | Integer | Error code. 0: success; other values: failure |
ErrorInfo | String | Error message |
RequestId | String | Unique Request ID is returned with each request and required to provide this RequestId when locating issues |
Token | String | |
IsTokenEnable | Bool | Whether callback authentication is enabled, true means enabled, false means disabled |
Error codes
Unless a network error occurs (e.g., 502 error), the HTTP status code for this interface will always be 200. The actual error codes and messages are conveyed through ErrorCode and ErrorInfo in the response body.
The private error codes for this API are as follows:
Error code | Description |
100001 | Internal server error, please retry |
100002 | Invalid parameter. Please check the request according to the error description. |
100302 | The authentication callback configuration does not exist. You can create one by setting the callback authentication Token interface. |
