即时通讯
机器人
ZIM Audio
当前页

CallAck

2026-11-06
POST

https://zim-api.zego.im/

通过该接口可以为用户发送回执。

用户接受邀请进入呼叫后,通过以下 ZIM SDK 的回调接口,其他处于呼叫中的用户会收到呼叫用户状态变更的通知:

iOSAndroidmacOSWindows
callUserStateChangedonCallUserStateChangedcallUserStateChangedonCallUserStateChanged
Web小程序FlutterReact Native
onCallUserStateChangedonCallUserStateChangedonCallUserStateChangedonCallUserStateChanged
Unity3Duniapp | uniapp xHarmonyOS
OnCallUserStateChangedcallUserStateChangedcallUserStateChanged
说明
调用频率限制:20 次/秒

Request

Query Parameters

    Action string必填

    可选值: [CallAck]

    接口原型参数

    https://zim-api.zego.im/?Action=CallAck

    AppId uint32必填

    💡公共参数。应用 Id,由 ZEGO 分配的用户唯一凭证。可从 ZEGO 控制台 获取。

    SignatureNonce string必填

    💡公共参数。16 位 16 进制随机字符串(8 字节随机数的 hex 编码)。生成算法可参考 签名示例。

    Timestamp int64必填

    💡公共参数。当前 Unix 时间戳,单位为秒。生成算法可参考 签名示例,最多允许 10 分钟的误差。

    SignatureVersion string必填

    可选值: [3.0]

    默认值: 3.0

    💡公共参数。签名版本号。

    Signature string必填

    💡公共参数。签名,用于验证请求的合法性。请参考签名机制生成。

Body

required
    FromUserId string必填

    可选值: <= 32 characters

    操作者(呼叫邀请接收方)的用户 ID,需要是已注册状态且为该呼叫的被叫成员。

    CallId string必填

    可选值: <= 32 characters

    呼叫 ID,来自呼叫创建接口的返回值。

Responses​

OK
Schema
    Code integer

    返回码。(0 表示成功)

    以下仅列出了接口业务逻辑相关的返回码,完整返回码请参考 全局返回码。

    返回码说明处理建议
    660000002参数错误请检查参数。
    660300005频率限制请稍后再尝试。
    660900004获取呼叫失败或已结束请检查 CallId 和呼叫状态。
    660900008用户不属于该呼叫请检查 FromUserId 是否为被叫成员。
    Message string

    返回状态信息。

    RequestId string

    请求唯一标识。

上一篇

拒绝呼叫邀请

下一篇

设置会话消息免打扰

当前页

返回到顶部