https://xxxxxx/v4/timpush/revoke?usersig=xxx&identifier=admin&sdkappid=88888888&random=99999999&contenttype=json
Parameter | Description |
https | The request protocol is HTTPS and the request method is POST. |
xxxxxx | The dedicated domain name corresponding to the country/region of the SDKAppID. China: console.tim.qq.com Singapore: adminapisgp.im.qcloud.com Seoul: adminapikr.im.qcloud.com Frankfurt: adminapiger.im.qcloud.com Silicon Valley: adminapiusa.im.qcloud.com Jakarta: adminapiidn.im.qcloud.com |
v4/timpush/revoke | Request API. |
usersig | |
identifier | The app admin account. |
sdkappid | The SDKAppID assigned by the Chat console when an application is created. |
random | A random 32-bit unsigned integer. |
contenttype | The value is always json . |
{"TaskId": "660cc447_537ed82a_200000cd7ee17f5_84035729_bc614e", // TaskId of push sent within 24 hours."OfflinePushInfo": { // If roaming/unread messages are not specified to be saved (OnlineOnlyFlag=0) during the push,// OfflinePushinfo must be included during recall."Title": "recall title","Desc": "The other party has recalled a message."}}
Field | Type | Required | Description |
TaskId | String | Yes | Push task ID. |
OfflinePushInfo | Object | No | Note: If OfflinePushinfo.PushFlag=1 or OfflinePushInfo is not set, offline push will not be overwritten. |
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 0}
Field | Type | Description |
ActionStatus | String | Processing result. OK : succeeded. FAIL : failed. |
ErrorCode | Integer | Error code. |
ErrorInfo | String | Error information. |
ErrorCode
and ErrorInfo
in the response packets represent the actual error code and error information. For common error codes (60000 to 79999), see Error Codes.
The following table describes the error codes specific to this API:Error Code | Description |
90001 | Failed to parse the JSON format. Check whether the request packets meet JSON specifications. |
90009 | The request requires app admin permissions. |
90049 | Recall TaskId is illegal and there is no push record. The returned TaskId can only be used for recall when the task is pushed through the timpush/push API. |
90050 | Repeated recall. Push tasks that have already been recalled cannot be called repeatedly. |
90051 | Recall is too frequent. The recall frequency limit is 1 time per second. |
90052 | The recall validity period has been exceeded. The recall must be within 24 hours, and push tasks that exceed 24 hours cannot be recalled. |
90053 | Invalid recall. Push with OnlineOnlyFlag=0, but the recall does not include OfflinePushInfo. |
91000 | Internal service error. Try again. |
Was this page helpful?