如果调用 OpenAPI 失败，你会在相应结果中看到错误码和错误信息。若对于部分调用或配置有特殊需求，请联系技术支持。以下是错误码，及对应的说明和处理方法：
| 错误码 | 说明 | 处理方法 |
|---|---|---|
JsonParsingError | Request Body 解析为 json 失败 | 请检查request body的json格式 |
ConversationNotFound | 会话不存在 | 请输入正确的会话 ID |
ParticipantNotInConversation | 会话成员不在会话中 | 请输入正确的会话 ID 或者会话成员 UserId |
InvalidParam | 参数非法 | 请确认接口详情中各个接口字段要求 |
MessageNotFound | 消息不存在 | 请输入正确的消息 ID |
SettingNotFound | setting 不存在 | 请输入正确的会话 ID 或者会话成员ID |
ParticipantNotFound | 会话成员不存在 | 请输入正确的会话 ID 或者会话成员 ID |
ConversationParticipantsMoreThanLimit | 会话中的成员超过限制 | 请前往控制台调整会话成员上限 |
CreateSingleConversationNeedOtherParticipantId | 创建单聊需要传入对方的 UserId | 请传入正确 OtherUserId |
SingleConversationNotSupport | 单聊会话不允许调此接口 | 单聊不允许调用此接口 |
OnlySingleConversationSupport | 只有单聊允许调用此接口 | 只有单聊允许调用此接口 |
ConversationShortIdsHasInvalidElem | 传入的会话 ID 数组中有异常的会话 ID | 请检查传入的会话 ID |
OwnerShouldBeEqual | 添加会话成员时，群主的 UserId 必须跟群聊的 OwnerUserId 保持一致 | 添加会话成员时，群主 UserId 需要和群聊的 OwnerUserId 保持一致，如需更换群主，请调用 update 接口进行更换 |
OnlyOwnerCanOperator | 仅有群主才能执行此操作 | 仅有群主可操作，请传入群主 UserId |
MoreThanUserConversationLimit | 超过用户加会话个数限制 | 请前往控制台调整用户加群个数限制 |
AppNotFound | 应用不存在 | 请输入正确的 AppId |
AppStatusException | 应用已经停用 | 请前往控制台开启应用 |
NoAuth | 无法访问非本账号创建的应用数据 | 请输入正确的 AppId |
LiveConversationNotSupport | 直播群不允许调用此接口 | 请输入正确的会话 ID |
OnlyLiveConversationSupport | 仅直播群支持此接口 | 请输入正确的会话 ID |
ManagerMoreThanLimit | 直播群管理员超过上限 | 默认上限 10 个 |
BlockConversationWhiteParticipantMoreThanLimit | 直播群禁言会话白名单个数超过上限 | 默认上限100个 |
ConversationMarkTypeMoreThanLimit | 直播群标记超过上限 | 默认上限20个 |
ConversationIsNotMute | 会话并未处于全员禁言状态，无法操作 | 请输入正确的会话 ID |
UserBroadcastMessageTTLMoreThanLimit | 全员广播消息过期时间设置超过上限 | 请调整消息过期时间 |
FriendMoreThanLimit | 好友个数超过上限 | 请勿添加超过上限数量的好友 |
AlreadyFriend | 对方已经是好友 | 请勿重复添加 |
NotFriend | 双方并不是好友，无法执行此操作 | 请输入正确的好友 ID |
NotInTheBlackList | 对方不在黑名单中 | 请输入正确的对方用户 ID |
AlreadyOnTheBlackList | 对方已经在黑名单中 | 请输入正确的对方用户 ID |
FriendUpdateTooFrequent | 好友更新过于频繁 | 请稍后重试 |
AddSelfNotAllow | 不可添加自己至黑名单 | 请输入正确的对方用户 ID |
BlackListMoreThanLimit | 黑名单用户数量超过上限 | 默认上限 1000 个 |
ParticipantIsBlock | 用户在黑名单中，无法执行该操作 | 请先把用户从黑名单中移除 |
UserHasRegistered | 用户已被注册过 | 请勿重复注册 |
UserNotFound | 用户未找到 | 请输入正确的用户 ID |
UpdateTooFrequent | 更新过于频繁 | 请稍后重试 |
MessageContentFormatInvalid | 编辑消息content传入了非法的content格式 | 请参考消息格式文档，传入正确的消息content格式 |
MessageEditRepeated | 要编辑的消息content跟原消息content相同，无需编辑 | 传入正确的消息content |
InternalError | 内部出现不符合预期的异常 | 请联系技术支持 |
AllMarkMessageReadExpireErr | 所有消息均已过期，过期消息无法查询已读回执 | 请输入未过期的消息 ID |
GroupMarkMessageReadIsNotEnabledErr | 未开通群聊已读回执功能 | 如需开通，请联系技术支持。 |
MarkMessageReadBeforeGroupMemberOverLimit | 超过一定人数的群聊暂不支持已读回执功能 | 默认超过200人的群聊不支持已读回执 |
BatchSendOverLimit | 超过一定人数不支持批量发单聊消息功能 | 默认最多支持500人的单聊消息群发 |
BatchSendOverQuota | 消息批量发送时，一分钟内消息数量超过 quota，默认为 12000 条/分钟 | 减少消息发送数量，限制在 12000 条/分钟以内 |
RateLimitExceeded | 接口调用超过限流值 | 降低对应接口调用频率 |