Callback on group left

Overview

With this callback, you can receive the callback on the group left by the user in real time, and view the information of the group left by the user.

Callback description

Request method: POST.
Note
The callback data format is JSON, and you need to perform UrlDecode decoding on it.
Request URL: The corresponding callback endpoint set in the ZEGOCLOUD Admin Console
Protocol: HTTPS/HTTP. HTTPS is recommended.

Callback parameters

Common parameter	Type	Description
appid	String	The unique identifier of the App.
event	String	The callback event. The return value of this callback is `group_destroy`.
timestamp	Int	The server time in Unix timestamp when the group is destroyed.
nonce	String	A random number, used to calculate the signature.
signature	String	The verification string. For details, see Authenticating server-to-server callbacks.

Parameters	Type	Description
group_id	String	The group ID.
exit_type	String	The way to exit the group: Quit: The user exits the group voluntarily. Kickout: The user is kicked out of the group.
operator_account	String	The user ID of the group leaver. When `exit_type` is `Quit`, this parameter is invalid; When `exit_type` is `Kickout`, this parameter is the user ID of the person who kicks the user out.
exit_user_ids	Array	The user IDs of the group members when the user exits the group.

Note

We recommend that you convert some parameters to Int for logical processing. The relevant fields include appid and nonce.

Sample code

Untitled

{
    "appid" : "1",
    "event" : "group_exit",
    "group_id" : "1",
    "nonce": "350176",
    "signature": "signature",
    "exit_type" : "Kickout",
    "operator_account" : "userA",
    "exit_user_ids" : ["Tony","Jenny"],
    "timestamp" : 1499676978
}

Copied!

Return codes

A status code of 2XX (such as 200) indicates success, and other responses indicate failure.

Callback retry policy

If the ZEGOCLOUD server does not receive a response, or the HTTP status code received by the ZEGOCLOUD server is not 2xx (such as 200), it will retry with intervals of 2s, 4s, 8s, 16s, and 32s respectively. If the retry still fails after an interval of 32s, it will no longer retry.

On this page