logo
控制台
即时通讯
服务端 API
API 概览
发布日志
调用方式
用户
房间
群组
消息
呼叫邀请
会话
ZIM Audio
回调说明
全局返回码
服务端 API 调测指南
Powered Byspreading
当前页

全局返回码

公共返回码

返回码描述可能原因处理建议
0请求成功。--
1请求失败。服务器繁忙。请稍后重试。
2输入参数错误。输入参数错误。请输入正确的参数。
3认证失败。认证失败。请联系 ZEGO 技术支持处理。
7每秒请求数超过系统设定值。服务请求过载。请稍后重试。
50014登录失败。UserName 超出限制。请确认 UserName 长度，最大 64 字节的字符串。
51102用户不存在。用户没有登录 ZIM。用户需要登录 ZIM。
105001请求失败。请求 DB 时失败。请联系 ZEGO 技术支持处理。
100000000请求 URL 头部中的 Host 错误。URL 地址中的 Host 错误。请确认请求 URL 是否正确。
100000001AppId 字段格式错误。AppId 字段格式错误。请确认 AppId 是否输入正确。
100000002Timestamp 字段为空。时间戳为空。请填写时间戳 Timestamp。
100000003Timestamp 字段格式错误。时间戳格式错误。请检查时间戳的格式是否正确。
100000004签名过期。签名过期。请重试。
100000005签名错误。签名过期。请重试。
100000006Action 为空。Action 为空。请确认请求 URL 是否正确。
100000007不支持的 Action。Action 错误。请确认请求 URL 是否正确。
100000008SignatureNonce 字段为空。SignatureNonce 字段为空。请重试。
100000009Signature 字段为空。Signature 字段为空。请重试。
100000010获取 ServerSecret 失败。内部错误。请联系 ZEGO 技术支持处理。
100000011获取 App 配置失败。内部错误。请联系 ZEGO 技术支持处理。
100000012读取 HTTP 包体失败。内部错误。请联系 ZEGO 技术支持处理。
100000013SignatureVersion 字段为空。SignatureVersion 字段为空。请重试。
100000014不支持的 SignatureVersion。不支持的 SignatureVersion。请确认 SignatureVersion 是否正确。
100000015网关内部错误。内部错误。请联系 ZEGO 技术支持处理。
100000016App 未配置正式环境。App 未配置正式环境。请确认 AppId 是否配置了正式环境的权限。
100000017App 未开通该服务。App 未开通该服务。请联系 ZEGO 技术支持处理。

业务返回码

返回码描述可能原因处理建议
660000001业务类通用错误。服务端出错。请重试，或联系 ZEGO 技术支持。
660000002输入参数错误。输入的参数缺失或不合法。请检查输入的参数。
660000003逻辑处理错误。服务端处理异常。请重试，或联系 ZEGO 技术支持。
660000011用户个数超过限制。输入的用户列表过大。请检查输入的用户列表。
660200001不存在的用户 ID，或者用户已经登出。不存在的用户 ID，或者用户已经登出。请确认用户 ID 是否存在或用户是否已登出 ZIM 服务。
660000012UserID 长度超过限制。UserID 最大长度为 32 字节。请确认 UserID 的长度。
660000022未找到消息，可能是消息已经被删除或者消息不存在。请检查消息是否被删除，以及 MsgSeq 是否正确。
660000023消息已被撤回。

请确认消息是否已被撤回。

  • 如经确认，消息已被撤回，则无需处理。
  • 如经确认，消息未被撤回，请联系 ZEGO 技术支持排查问题。
660000024已超过撤回时间。如需撤回更长时间内的消息，请联系 ZEGO 技术支持进行配置。
660000025调用服务端接口发送信令消息时，MessageBody 中 IsBase64 传入 1 后，发送经 base64 编码的信令消息失败。Message 内容没有经过 base64 编码。

请确认：

  • IsBase64 是否需要为 1，即是否需要发送二进制类型信令消息。
  • Message 内容是否经 base64 编码。
660000026待撤回消息与 FromUserId 不匹配。请检查 FromUserId 字段是否正确。
660000027未启用保存房间消息配置，无法撤回消息。请开通 ZIM 旗舰版服务。
660300001房间不存在。输入的 RoomId 不存在或房间已被销毁。请确认输入的 RoomId 是否正确或房间是否已被销毁。
660300002用户不在此房间内。输入的 UserId 不存在或不在此房间内。请确认输入的 UserId 是否正确。
660300005调用接口的频率超出了 AppID 级别限制。请稍后再试，或参考相关文档了解调用频率。
660300006调用接口的频率超出了群/房间限制。请稍后再试，或参考相关文档了解调用频率。
660300007获取房间失败。内部错误。请联系 ZEGO 技术支持。
660300008获取房间用户列表失败。房间人数为空，一般是处于房间延迟销毁期间。无需操作。
660300012用户不在指定房间内。用户不在指定房间内。无需处理。
660400001消息大小超出限制。输入的消息过大。请检查输入的消息大小。
660500002操作者用户未注册。操作者用户未登录过 SDK。请让操作者先注册 ZIM 服务。
660500003调用 SendMessageToAllUsers 接口的频率超出限制。调用接口频率超出限制。默认 1 次/秒，每 24 小时内仅限 100 次，请稍后再试。
660500004文本审核请求出错。文本审核请求出错。请联系 ZEGO 技术支持。
660500005发送的文本消息没有通过审核。发送的文本消息没有通过审核。请勿发送该消息。
660500006图片审核请求出错。图片审核请求出错。请联系 ZEGO 技术支持。
660500007发送的图片消息没有通过审核。发送的图片消息没有通过审核。请勿发送该消息。
660500009您的业务后台判断此消息应当“静默发送”。收到“消息发送前回调”后，您的业务后台返回了 2，此消息被静默发送。无需处理。
660500010您的业务后台判断此消息应当“不发送”。收到“消息发送前回调”后，您的业务后台返回了 3，此消息被拒绝发送。无需处理。
660600001群组不存在。输入的 GroupId 不存在。请确认输入的 GroupId 是否正确。
660600003查询群成员列表出错。服务端处理异常。请联系 ZEGO 技术支持。
660600004调用 QueryGroupMemberList 接口的频率超出限制。调用接口频率超出限制。调用频率为 20 次/秒，请勿超出限制。
660600005调用 KickoutGroupUser 接口的频率超出限制。调用接口频率超出限制。调用频率为 20 次/秒，请勿超出限制。
660600006查询群列表数据出错。服务端处理异常。请联系 ZEGO 技术支持。
660600007调用 QueryAppGroupList 接口的频率超出限制。调用接口频率超出限制。调用频率为 1 次/秒，请稍后重试。
660600008需要被移除的用户不在群内。用户已退出群组。无需处理。
660600009获取群相关信息失败。该群组可能不存在。请先确认 GroupID 是否正确。如果正确，请联系 ZEGO 技术支持。
660600010调用 CreateGroup 接口的频率超出限制请求。发起请求频率上限为 20 次/秒。请稍后再试。
660600011群已经存在。使用了现有群的 GroupID。请使用其他 GroupID。
660600012群数量超过限制。创建的群数量达到了套餐上线。请升级套餐。
660600013群主不存在。群主的用户 ID 出错。请检查群主的用户 ID 是否正确。
660600014修改群主的群列表出错。修改群主的群列表出错。请联系 ZEGO 技术支持。
660600015ZIM 服务端执行 db 操作出错。ZIM 服务端执行 db 操作出错。请联系 ZEGO 技术支持。
660600016群成员数量超过限制。创建群组时最多一次性添加 100 名用户。请减少群成员数量。
660600017创建群时用户进群失败。创建群时用户进群失败。请联系 ZEGO 技术支持。
660600019属性数量超过限制。群属性数量默认上限为 10 个。请减少群属性。
660600020属性的 Key 或 Value 长度错误。Key 的长度上限为 16 字节，Value 的长度上限为 1024 字节。请检查相关参数的长度。
660600021发送消息参数错误。发送消息参数错误。请检查参数。
660600022发送多媒体消息，获取重定向地址失败。发送多媒体消息，获取重定向地址失败。请联系 ZEGO 技术支持处理。
660600023消息长度超过限制。消息长度超过限制。请缩小消息长度。
660600024用户不在群内。请检查用户或添加用户为群成员。
660600029Role 不能设置为 1。请修改 Role。
660600030FromUserId 不能和 ToUserId相等。请修改 ToUserId。
660600032FromUserId 没权限。FromUserId 需为群主或管理员。
660600033对全部指定用户的操作均失败。请检查 UserIds。
660700001调用 UserRegister 接口的频率超出限制请求。发起请求频率上限为 20 次/秒。请稍后再试。
660700002用户已存在。发送请求的 UserID 已存在。请避免重复注册相同的 UserID。
660700006UserName 长度超过限制。UserName 长度最大为 64 字节。请确认 UserName 的长度。
660700007UserAvatar 地址长度超过限制。UserAvatar 地址长度最大为 500 字节。请确认 UserAvatar 的长度。
660700008获取用户信息出错。用户 ID 错误。请检查用户 ID 是否正确。
660700012用户不存在。请先注册用户。
660700013查询用户信息出错。请联系 ZEGO 技术支持。
660700015用户未注册。请先注册用户。
660700016同步用户信息出错。请联系 ZEGO 技术支持。
660700017更新用户信息出错。请联系 ZEGO 技术支持。
660800001置顶单聊会话时，操作目标会话 ConvID 对应的用户未注册。请确认该 ConvId 对应的用户是否已注册：
  • 确认已注册，请联系 ZEGO 技术支持排查。
  • 确认未注册，请注册此用户。
660800019单次批量操作超过上限。减少单次批量操作数量。
660800020不能将 FromUserId 添加为好友，即 FriendInfos 中的 UserId 不能与 FromUserId 相同。请修改 FriendInfos 中与 FromUserId 相同的 UserId。
660800021FriendAlias 或 Wording 超过长度上限。请缩减相关字段的内容长度。
660800022参数中的用户 ID 相关参数重复。请删除或修改重复参数。
660800023Attributes 的 Key 取值不属于 k0 ~ k4。请修改 Key 的值。
660800024Attributes 的所有 Key、Value 总长度超过长度上限。请缩减相关字段的内容长度。
660800025所有好友均未注册过，接口调用失败。请先注册目标用户。
660800026好友属性参数错误。请检查输入的参数。
660800027目标用户已经是好友，无需重复添加。无需操作。
660800028FromUserId 的好友数量到达上限。无法添加更多好友。
660800030用户的免打扰列表超过长度限制，默认 500。请缩短列表，或联系技术支持提高上限，最大可为 1000。
660800032Attributes 有重复的 Key。请修改 Key。
660800033UserIds 中的字符串不能与 FromUserId 相同请修改 UserIds 中与 FromUserId 相同的字符串。
660800034目标用户不是 FromUserId 的好友。如需修改对此用户的备注，请先添加此用户为好友。
660800037用户已被拉黑，无需重复操作。无需处理。
660800038不能拉黑 FromUserId 或将 FromUserId 移除黑名单。请修改 UserIds。
660800039传入的用户列表超过限制。请缩短传入的用户列表。
660800040FromUserId 的黑名单已达上限，无法拉黑更多用户。无需处理。
660800041拉黑全部指定用户失败。请参考响应参数 ErrList 的 SubCode 处理.
660800042全部指定用户移出黑名单失败。请参考响应参数 ErrList 的 SubCode 处理.
660800043此用户已被移出黑名单。无需处理。
660800044此用户不在黑名单。无需处理。
660800045消息发送方已被消息接收方拉黑，导致消息发送失败。无需处理。
660800046传递的时间戳大于当前时间。可以不填，默认是当前时间。
660800048置顶列表长度超过限制（100，不可配置）。无需处理。
660800051会话已为免打扰，无法再次设置为免打扰。无需处理。
660800052会话已被取消免打扰，无法再次取消。无需处理。
660800053查询会话列表失败。请联系 ZEGO 技术支持。
660900003所有被叫用户需为已注册。请检查被叫用户的注册状态或稍后再试。
660900004获取呼叫信息异常。请检查呼叫是否存在，或者稍后再试。
660900005呼叫已结束，无法对其进行操作。无需处理。
660900006呼叫邀请已超时，无法对其进行操作。无需处理。
660900007被叫用户列表长度超过限制。请缩短被叫用户列表长度，或联系 ZEGO 技术支持上调上限。
660900008该呼叫没有邀请操作用户，无法对其进行操作。无需处理。

Previous

回调校验说明

Next

服务端 API 调测指南

当前页

返回到顶部