即时通讯
  • iOS : Objective-C
  • Android
  • macOS
  • Windows
  • Web
  • 小程序
  • Flutter
  • Unity3D
  • uni-app
  • React Native
  • 产品简介
  • 下载
  • 快速开始
    • 跑通示例源码
    • 实现基本消息收发
  • 用户相关
  • 房间相关
  • 群组相关
  • 消息相关
  • 呼叫邀请
  • 会话管理
  • 缓存管理
  • 离线推送
  • 语音组件
  • 客户端 API
  • 服务端 API
  • 迁移方案
  • SDK 错误码
  • 常见问题
  • 文档中心
  • 即时通讯
  • 服务端 API
  • 全局返回码

全局返回码

更新时间:2024-01-12 16:25

公共返回码

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

业务返回码

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

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

  • IsBase64 是否需要为 1,即是否需要发送二进制类型信令消息。
  • Message 内容是否经 base64 编码。
660000026
待撤回消息与 FromUserId 不匹配。
请检查 FromUserId 字段是否正确。
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 技术支持。
660600015
ZIM 服务端执行 db 操作出错。
ZIM 服务端执行 db 操作出错。
请联系 ZEGO 技术支持。
660600016
群成员数量超过限制。
创建群组时最多一次性添加 100 名用户。
请减少群成员数量。
660600017
创建群时用户进群失败。
创建群时用户进群失败。
请联系 ZEGO 技术支持。
660600019
属性数量超过限制。
群属性数量默认上限为 10 个。
请减少群属性。
660600020
属性的 Key 或 Value 长度错误。
Key 的长度上限为 16 字节,Value 的长度上限为 1024 字节。
请检查相关参数的长度。
660600021
发送消息参数错误。
发送消息参数错误。
请检查参数。
660600022
发送多媒体消息,获取重定向地址失败。
发送多媒体消息,获取重定向地址失败。
请联系 ZEGO 技术支持处理。
660600023
消息长度超过限制。
消息长度超过限制。
请缩小消息长度。
660700001
调用 UserRegister 接口的频率超出限制请求。
发起请求频率上限为 20 次/秒。
请稍后再试。
660700002
用户已存在。
发送请求的 UserID 已存在。
请避免重复注册相同的 UserID。
660700006
UserName 长度超过限制。
UserName 长度最大为 64 字节。
请确认 UserName 的长度。
660700007
UserAvatar 地址长度超过限制。
UserAvatar 地址长度最大为 500 字节。
请确认 UserAvatar 的长度。
660700008
获取用户信息出错。
用户 ID 错误。
请检查用户 ID 是否正确。
660700012
用户未注册。
请先注册用户。
660700013
查询用户信息出错。
请联系 ZEGO 技术支持。
660700016
同步用户信息出错。
请联系 ZEGO 技术支持。
660700017
更新用户信息出错。
请联系 ZEGO 技术支持。
本篇目录