文档中心
即时通讯
服务端 API
全局返回码

全局返回码

更新时间：2024-10-15 23:28

公共返回码

返回码	描述	可能原因	处理建议
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	调用服务端接口发送信令消息时，`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 技术支持。
660600015	ZIM 服务端执行 db 操作出错。	ZIM 服务端执行 db 操作出错。	请联系 ZEGO 技术支持。
660600016	群成员数量超过限制。	创建群组时最多一次性添加 100 名用户。	请减少群成员数量。
660600017	创建群时用户进群失败。	创建群时用户进群失败。	请联系 ZEGO 技术支持。
660600019	属性数量超过限制。	群属性数量默认上限为 10 个。	请减少群属性。
660600020	属性的 Key 或 Value 长度错误。	Key 的长度上限为 16 字节，Value 的长度上限为 1024 字节。	请检查相关参数的长度。
660600021	发送消息参数错误。	发送消息参数错误。	请检查参数。
660600022	发送多媒体消息，获取重定向地址失败。	发送多媒体消息，获取重定向地址失败。	请联系 ZEGO 技术支持处理。
660600023	消息长度超过限制。	消息长度超过限制。	请缩小消息长度。
660600024	用户不在群内。		请检查用户或添加用户为群成员。
660600029	Role 不能设置为 1。		请修改 Role。
660600030	FromUserId 不能和 ToUserId相等。		请修改 ToUserId。
660600032	FromUserId 没权限。		FromUserId 需为群主或管理员。
660600033	对全部指定用户的操作均失败。		请检查 UserIds。
660700001	调用 UserRegister 接口的频率超出限制请求。	发起请求频率上限为 20 次/秒。	请稍后再试。
660700002	用户已存在。	发送请求的 UserID 已存在。	请避免重复注册相同的 UserID。
660700006	UserName 长度超过限制。	UserName 长度最大为 64 字节。	请确认 UserName 的长度。
660700007	UserAvatar 地址长度超过限制。	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`。
660800021	`FriendAlias` 或 `Wording` 超过长度上限。		请缩减相关字段的内容长度。
660800022	参数中的用户 ID 相关参数重复。		请删除或修改重复参数。
660800023	`Attributes` 的 `Key` 取值不属于 k0 ~ k4。		请修改 `Key` 的值。
660800024	`Attributes` 的所有 `Key`、`Value` 总长度超过长度上限。		请缩减相关字段的内容长度。
660800025	所有好友均未注册过，接口调用失败。		请先注册目标用户。
660800026	好友属性参数错误。		请检查输入的参数。
660800027	目标用户已经是好友，无需重复添加。		无需操作。
660800028	`FromUserId` 的好友数量到达上限。		无法添加更多好友。
660800030	用户的免打扰列表超过长度限制，默认 500。		请缩短列表，或联系技术支持提高上限，最大可为 1000。
660800032	`Attributes` 有重复的 `Key`。		请修改 `Key`。
660800033	`UserIds` 中的字符串不能与 `FromUserId` 相同		请修改 `UserIds` 中与 `FromUserId` 相同的字符串。
660800034	目标用户不是 `FromUserId` 的好友。		如需修改对此用户的备注，请先添加此用户为好友。
660800037	用户已被拉黑，无需重复操作。		无需处理。
660800038	不能拉黑 `FromUserId` 或将 `FromUserId` 移除黑名单。		请修改 UserIds。
660800039	传入的用户列表超过限制。		请缩短传入的用户列表。
660800040	`FromUserId` 的黑名单已达上限，无法拉黑更多用户。		无需处理。
660800041	拉黑全部指定用户失败。		请参考响应参数 `ErrList` 的 `SubCode` 处理.
660800042	全部指定用户移出黑名单失败。		请参考响应参数 `ErrList` 的 `SubCode` 处理.
660800043	此用户已被移出黑名单。		无需处理。
660800044	此用户不在黑名单。		无需处理。
660800046	传递的时间戳大于当前时间。		可以不填，默认是当前时间。
660800048	置顶列表长度超过限制（100，不可配置）。		无需处理。
660800051	会话已为免打扰，无法再次设置为免打扰。		无需处理。
660800052	会话已被取消免打扰，无法再次取消。		无需处理。
660800053	查询会话列表失败。		请联系 ZEGO 技术支持。
660900003	所有被叫用户需为已注册。		请检查被叫用户的注册状态或稍后再试。
660900004	获取呼叫信息异常。		请检查呼叫是否存在，或者稍后再试。
660900005	呼叫已结束，无法对其进行操作。		无需处理。
660900006	呼叫邀请已超时，无法对其进行操作。		无需处理。
660900007	被叫用户列表长度超过限制。		请缩短被叫用户列表长度，或联系 ZEGO 技术支持上调上限。
660900008	该呼叫没有邀请操作用户，无法对其进行操作。		无需处理。