回调配置说明

---

在使用 ZEGO 服务端 API 时，开发者可通过回调服务对接业务后台，进一步保证业务的有序和正常。

1 使用场景

例如：

• 客户端推流成功后，业务后台可以接收 ZEGO 服务端的 流创建回调，用于增加直播列表 (可维护直播列表)。

• 客户端停止推流后，业务后台可以接收 ZEGO 服务端的 流关闭回调，用于删除直播列表 (可维护直播列表)。

• 客户端结束直播后，业务后台可以接收 ZEGO 服务端的 录制文件生成回调，用于实现点播服务。

2 回调配置

开发者可根据实际业务需要，在 ZEGO 控制台 的 “项目配置 > 服务端回调配置” 中进行回调信息的配置。

同时，可按需配置接收 ZEGO 回调的 URL 地址。

3 回调说明

• 请求方法：POST。

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

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

4 返回响应

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

5 回调重试策略

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