呼叫取消回调

---

描述

当出现以下情况（可分为两类）时，业务后台可以接收 ZIM 服务端的呼叫取消回调，用于确定呼叫状态：

• 主动取消：

  • 呼叫发起用户主动取消呼叫。
  • 在呼叫邀请成功创建后至其超时前，没有任何呼叫对象接受，发起用户主动登出。
  • 在呼叫邀请成功创建后至其超时前，没有任何呼叫对象接受，发起用户因心跳超时导致掉线。

• 超时取消：

  • 在呼叫邀请成功创建后至其超时时，没有任何呼叫对象响应，发起用户在线。

    如果在呼叫成功创建后至呼叫超时时，没有任何呼叫对象响应，发起用户掉线，则会触发 呼叫超时回调。

回调说明

• 请求方法：POST。

  • 回调数据需要 UrlDecode 解码。
  • 使用 POST 请求方法传递参数时：
    • Body 中的参数直接传 JsonObject 格式即可，无需序列化为 String 格式。
    • Headers 中，设置 “Content-type” 为 “application/json”。

• 请求地址：请在 ZEGO 控制台 上配置回调地址，配置流程请参考控制台文档 ZIM 相关回调配置。

• 传输协议：HTTPS/HTTP，建议使用 HTTPS。

回调参数

数据示例

{
    "appid": "1",
    "event": "call_cancel",
    "nonce": "350176",
    "signature": "signature",
    "timestamp": 1499676978,
    "call_id": "3501761173612493269",
    "user_ids": ["abc","def"],
    "reason": "caller_cancel",
    "payload": "payload",
}

返回响应

返回 HTTP status code 为 2XX （例如 200）表示成功，其他响应都表示失败。

回调重试策略

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