文档中心
IM 即时通讯
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 即时通讯
  • 服务端 API
  • 回调说明
  • 呼叫超时回调

呼叫超时回调

更新时间:2024-08-06 19:23

描述

在呼叫创建成功后,如果出现以下情况时,业务后台可以接收 ZIM 服务端的呼叫超时回调,用于确定呼叫超时用户:

  • 在后台配置的超时时间内,呼叫发起用户在线,部分呼叫对象一直未响应。
  • 在创建呼叫时设置的超时时间内,呼叫发起用户在线,部分呼叫对象一直未响应。
  • 在呼叫超时时,呼叫发起用户掉线,全体呼叫对象都未响应。

如果全体呼叫对象都在规定时间内未响应,并且呼叫发起用户在线,会触发 呼叫取消回调。

回调说明

  • 请求方法:POST。

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

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

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

回调参数

参数 类型 说明
appid String APP 的唯一标识。
event String 回调事件,此回调返回值为 call_timeout。
nonce String 随机数。
signature String 检验串,详情见 检验说明。
timestamp Int 服务器当前时间,Unix 时间戳。
call_id String 呼叫 ID。
user_ids Array of String 不应答用户 ID 列表。

建议您将部分参数转换为 Int 进行逻辑处理,相关字段包括 appid 和 nonce。

数据示例

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

返回响应

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

回调重试策略

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

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

    联系我们

  • 文档反馈