tencent cloud

All product documents
Chat
API Overclocking Alarm Callbacks
Last updated: 2024-05-08 16:34:56
API Overclocking Alarm Callbacks
Last updated: 2024-05-08 16:34:56

Feature Overview

When the request frequency of the API exceeds 80% of the threshold, the app backend is notified of the call frequency alarm information through a callback.

Notes

To enable the callback, you must configure the callback URL. For detailed configuration methods, see Webhook Configuration.
Once the callback URL is configured, an alarm callback is triggered by default if the request frequency exceeds the alarm threshold.
During this callback, the Chat backend initiates an HTTP POST request to the app backend.
After receiving the callback request, the app backend must check whether the SDKAppID contained in the request URL is consistent with its own SDKAppID.
For other security-related matters, see Webhook Overview - Security Considerations.

API Description

Sample Request URL

In the following example, the callback URL configured in the app is https://www.example.com Example:
https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&OptPlatform=$OptPlatform&contenttype=json

Request Parameters

Request Parameters

Parameter
Description
https
The request protocol is HTTPS, and the request method is POST.
www.example.com
Callback URL
SdkAppid
SDKAppID allocated by the Chat console at the time of application creation
CallbackCommand
Fixed as Alert.RequestOverLimit
contenttype
Fixed value: JSON
OptPlatform
Client platform. For values, see Webhook Overview - Webhook Protocol for the meaning of the OptPlatform parameter.

Sample Request Packet

{ "CallbackCommand": "Alert.RequestOverLimit", "ServiceName": "openim", "Command": "batchsendmsg", "Request": 510, "Limit": 200 }

Request Packet Fields

Field
Type
Description
CallbackCommand
String
Fixed as Alert.RequestOverLimit
ServiceName
String
Internal service name of API. Different ServiceNames correspond to different service types.
Command
String
API command word, combined with ServiceName to identify specific business features.
Request
Integer
API request QPS rate
Limit
Integer
API request QPS threshold

Sample Response Packet

{
"ActionStatus": "OK",
"ErrorInfo": "",
"ErrorCode": 0
}

Response Packet Fields

Field
Type
Description
ActionStatus
String
Request processing result:
OK indicates successful processing.
FAIL indicates failed processing.
ErrorCode
Integer
Error code
ErrorInfo
String
Error description

References


Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon