文档中心
ExpressAudioSDK 实时语音
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 实时语音
  • 服务端 API
  • 回调说明
  • 回调配置说明

服务端 API 版块于4月16日至5月15日升级维护,期间暂停信息更新,如有任何疑问,请联系ZEGO技术支持。

回调配置说明

更新时间:2025-04-15 17:17

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

回调服务不能保证完全可靠,请慎重考虑使用回调方案构建核心业务流程的风险。

1 使用场景

例如:

  • 客户端推流成功后,业务后台可以接收 ZEGO 服务端的 流创建回调,用于增加直播列表 (可维护直播列表)。
  1. 流创建回调中的 “pic_url” 可用于鉴黄,默认 20s 一张的缓存图片。
  2. “pic_url” 只能在推流过程中使用,推流结束后无效。
  • 客户端停止推流后,业务后台可以接收 ZEGO 服务端的 流关闭回调,用于删除直播列表 (可维护直播列表)。

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

2 回调配置

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

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

可按如下方式查看控制台界面:

  • 2021-11-16 之后注册 ZEGO 控制台 的用户,请参考 控制台 - 服务端回调配置。
  • 2021-11-16 及之前注册 ZEGO 控制台 的用户,请参考 控制台(旧版) - 项目管理 中的 “高级配置”。

3 回调说明

  • 请求方法:POST。

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

  • 传输协议:HTTPS/HTTP,建议使用 HTTPS。

4 返回响应

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

5 回调重试策略

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

本篇目录
  • 免费试用
  • 提交工单
    咨询集成、功能及报价等问题
    电话咨询
    400 1006 604
    咨询客服
    微信扫码,24h在线

    联系我们

  • 文档反馈