tencent cloud

フィードバック

API Overclocking Alarm Callbacks

最終更新日: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

    
    お問い合わせ

    カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

    テクニカルサポート

    さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

    電話サポート(24 時間365日対応)