logo
即时通讯
当前页

加入群组


描述

凭借本回调,您可以实时查看用户加入特定群组的信息,可用于通知后台有成员入加群组。

回调说明

  • 请求方法:POST。
    说明

    回调数据格式为 JSON,您需要对其进行 UrlDecode 解码。

  • 请求地址:请在 ZEGO 控制台 上配置回调地址,配置流程请参考控制台文档 ZIM 相关回调配置
  • 传输协议:HTTPS/HTTP,建议使用 HTTPS。

回调参数

公共参数类型说明
appidStringApp 的唯一标识。
eventString回调事件,此回调返回值为 group_join
timestampInt加入群组的时间,以服务器当前时间记录,Unix 时间戳,单位为秒(s)。
nonceString随机数,用于计算 signature。
signatureString检验串,详情见 检验说明
业务参数类型说明
group_idString群组 ID。
join_typeString入群方式:
  • Apply:用户通过申请入群。
  • Invited:用户通过邀请进群。
operator_accountString入群操作者的用户 ID。
  • join_typeApply 时,此参数无效;
  • join_typeInvited 时,此参数为邀请者的用户 ID。
new_user_idsArrays进入群组的用户 ID。

数据示例

Untitled
{
    "appid" : "1",
    "event" : "group_join",
    "group_id" : "1",
    "nonce": "350176",
    "signature": "signature",
    "operator_account" : "userA",
    "join_type" : "Apply",
    "new_user_ids" : ["Tony","Jenny"],
    "timestamp" : "1499676978"
}
1
Copied!

返回响应

返回 HTTP status code 为 2XX (例如 200)表示成功,其他响应都表示失败。

回调重试策略

如果 ZEGO 服务器没有收到响应,或收到的 HTTP status code 不为 2XX(例如 200),都会尝试重试,最多进行 5 次重试。每次重试请求与上一次请求的间隔时间分别为 2s、4s、8s、16s、32s。若第 5 次重试后仍然失败,将不再重试,该回调丢失。

Previous

创建群组

Next

离开群组