状态码

HTTP 状态码

状态码	描述	详细解释
200	成功	成功
400	请求参数错误	该请求是无效的，详细的错误信息会说明原因
401	未授权	验证失败，详细的错误信息会说明原因
403	服务器拒绝请求	被拒绝调用，详细的错误信息会说明原因
404	未找到	服务器找不到请求的地址
405	请求方法不支持	群容量超出上限，禁止请求此方法
429	请求频率超限	超出了调用频率限制，详细的错误信息会说明原因
430	未开通服务	一般为未开通服务导致，详细的错误信息会说明原因
500	服务器内部错误	服务器内部出错了，请联系我们尽快解决问题
504	网关超时	服务器在运行，本次请求响应超时，请稍后重试

业务返回码

400

用户 ID 不存在。

排查建议：用户 ID 需要注册，详情请参阅注册用户。

404

服务器找不到请求的地址（HTTP 状态码 404）。

排查建议：请求的接口地址不存在，详情请参阅接口地址。

1000

请求参数错误/内部逻辑错误/包名个数已超限。

排查建议： errorMesage 有详细的错误信息，详细检查请求参数，如无法解决，请提交工单与我们联系，并附上请求参数。

1001

App Secret 错误。

排查建议： errorMesage AppKey 与 AppSecret 不匹配，在融云控制台查看对应的Secret。

1002

参数错误，详细的描述信息会说明。

排查建议： errorMesage 有详细的错误信息，详细检查请求参数，如无法解决，请提交工单与我们联系，并附上请求参数。

1003

聊天室 ID 不能为空，或者 minute 参数不合法。

排查建议：聊天室 ID 不能为空，或者 minute 参数不合法。

1004

验证签名错误。

排查建议：请检查是否使用 Secret 算的签名，详情请参阅请求签名。

1005

参数长度超限，详细的描述信息会说明。

排查建议：参数长度超限，详细的 errorMesage 描述信息会说明。

1006

此 App 已下线，无法发起请求。

排查建议：此 App 已下线，无法发起请求，检查请求的服务端域名，请求检查您要使用的域名。

1007

IP 限制，访问被禁止。

排查建议：该方法被限制调用，详细的描述信息会说明。

1008

接口调用超过频率限制，请稍后再发起请求。

排查建议：接口调用超过频率限制，每个接口对应的限制不一样，可以看文档中接口的频率限制。

1009

未开通该服务，请到融云控制台开通或提交工单申请。

排查建议：未开通该服务，请求根据 errorMessage 的提示到融云控制台开通或提交工单工单申请。

1010

未开启白名单功能，无法操作白名单。

排查建议：未开启白名单功能，无法操作用户白名单，请到融云控制台开通单聊用户白名单。

1011

未开启黑名单功能，无法操作黑名单。

排查建议：未开启黑名单功能，无法操作用户黑名单，请到融云控制台开通单聊用户黑名单。

1015

删除的数据不存在。

排查建议：要删除的保活聊天室 ID 不存在。

1016

设置的保活聊天室个数超限。

排查建议：设置的保活聊天室个数超限，如需要多个请联系商务。

1018

实时音视频服务未开启。

排查建议：可以在融云控制台开通音视频服务。

1050

内部服务超时。

排查建议：内部服务响应超时（HTTP 状态码 504）。

2007

注册用户数量超限。

排查建议：

1. 开发环境下注册用户上限为 100 个，生产环境未开通 IM 付费版本时可免费注册 100个 可以在融云控制台删除用户。
2. 单独使用音视频服务没有注册用户数限制，如您单独使用音视频服务触发了该错误，请检查您的音视频服务是否因欠费或其它原因处于关停状态。
3. 注销的用户也占用用户数量并且在融云控制台看不到，需要重新激活用户再删除。

20107

单聊黑名单人数超限。

排查建议：用户 ID 的黑名单人数已达到上限（3000)，可以清理一些黑名单人数。

20108

单聊白名单人数超限。

排查建议：用户 ID 的白名单人数已达到上限 (3000)，可以清理一些白名单人数。

22201

超级群扩展消息，但是原始消息不存在。

排查建议：

1. 超级群历史消息默认存储 7 天，超过 7 天的消息会被删除，可根据消息的 sentTime 判断是否为 7 天前的消息。
2. 原消息可能已经被手动删除，可通过获取超级群会话历史消息确认原消息是否存在。

22202

超级群扩展消息，但是原始消息不支持扩展。

排查建议：发送消息将 canIncludeExpansion 设置为 true 后，该消息才支持扩展，详情请参阅收发消息文档。

22203

超级群扩展消息，扩展内容格式错误。

排查建议：设置的扩展内容服务端解析失败，扩展内容必须为 JSON 字符串格式，例如：{"key":"value"}。

22204

超级群扩展消息，无操作权限。

排查建议：传入的会话类型参数错误，请检查传入的会话类型值是否为 10。

23407

聊天室禁言白名单人数超限(最多5个)。创建聊天室时，禁言白名单用户列表，支持批量设置，最多不超过 20 个。

排查建议：

1. 加入聊天室用户白名单，传入 user ID 超限（最多 5 个），接口详情请参阅加入聊天室用户白名单。
2. 加入聊天室全体禁言白名单，传入 user ID 超限（最多 20 个），接口详情请参阅加入聊天室全体禁言白名单。

23410

聊天室不存在。

排查建议：

1. 聊天室具有自动销毁机制和离线成员自动退出机制，详情请参阅聊天室销毁机制和退出聊天室文档，业务层可观察一下是否因为上述机制导致。
2. 也可通过融云控制台 > 北极星 > Server Api 调试聊天室模块进行查询，创建等动作。

23423

聊天室的 KV 属性个数超限。

排查建议：单个聊天室默认上限为 100 个。

23424

没有权限修改聊天室中已存在的属性值。

排查建议：业务层没有权限修改其他人设置的 KV 属性值，如果要设置需要调用强制设置接口，详情请参阅聊天室属性管理(KV)文档。

23426

未开通聊天室属性自定义设置服务。

排查建议：可在融云控制台 > 应用配置 > IM 服务 > 免费基础功能开通聊天室属性自定义设置。

23427

聊天室属性不存在。

排查建议：

1. 可通过查询聊天室属性确认属性是否存在。
2. 聊天室销毁后，聊天室中的自定义属性同时销毁。
3. 设置属性时 autoDelete 参数为 1，表示操作用户退出聊天室后属性自动删除。
4. 如果业务层排除主动删除，想了解属性不存在原因，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID ，聊天室 ID ，属性 KV，问题发生时间等。

23432

聊天室销毁时间不合法。

排查建议：设置聊天室销毁时间（分钟）非有效值时，返回该错误码。有效值为[60 - 10080] 的整数。

23433

聊天室销毁类型不合法。

排查建议：设置聊天室销毁类型非有效值时，返回该错误码。有效值请参见文档中定义的类型对应值。

23434

聊天室属性无对应用户 ID 。

排查建议：如果设置聊天室自定义属性，必须同时传用户 ID ，否则返回该错误码。

23435

聊天室已存在。

排查建议：创建聊天室时聊天室已存在，返回该错误码。

23436

聊天室存活时长无效。

排查建议：为定时销毁的聊天室设置存活时长时，应保证传入的存活时长大于聊天室自创建后的已存活时长，否则返回该错误码。

24353

重复注销。

排查建议：调用注销接口，传入已完成注销的用户 ID 时，返回该错误码。

24354

重复激活。

排查建议：调用重新激活用户 ID 的接口，传入已激活的用户 ID 时，返回该错误码。

24356

用户注销中。

排查建议：调用注销接口，传入正在注销流程中的用户 ID 时，返回该错误码。

24362

用户托管扩展属性的 key 列表中没有此 key。

排查建议：修改用户托管信息的 userExtProfile 字段时，key 不存在，扩展用户信息的 Key 需通过融云控制台进行设置，详情请参阅设置用户信息。

24363

超过了可以设置的用户托管扩展属性的最大上限。

排查建议：用户托管扩展属性的最大上限值为 20.

24366

未在用户托管业务中查询到此用户应用号

排查建议：用户应用号未设置。请先设置用户应用[/platform-chat-api/user/user-profiles/set-user-profiles]，再重试

24369

未开启用户信息托管功能。

排查建议：可在融云控制台 > 应用配置 > IM 服务 > 信息托管服务 > 功能设置开启用户信息托管服务。

24401

超级群功能未开通。

排查建议：可在融云控制台 > 应用配置 > IM 服务 > 超级群服务开启超级群服务。

24402

超级群服务异常。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID ，问题发生时间等。

24403

超级群参数错误。

排查建议：请根据文档检查传入参数格式是否正确。

24404

超级群未知异常。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID ，问题发生时间等。

24406

非超级群成员。

排查建议：可通过融云控制台 > 北极星 > Server Api 调试超级群模块进行查询，加入等动作。

24408

超级群成员禁言。

排查建议：详情请参阅超级群禁言服务。

24410

超级群不存在。

排查建议：可通过融云控制台 > 北极星 > Server Api 调试超级群模块进行创建。

24412

用户加入超级群数量超限。

排查建议：用户加入超级群数量超限，每个用户最多可加入 100 个超级群。

24413

创建超级群频道，频道数超限。

排查建议：该超级群下创建的频道数超限，每个超级群下默认可创建 50 个频道。

24414

超级群频道 ID 不存在。

排查建议：

1. 业务层可按需通过融云控制台 > 北极星 > Server Api 调试超级群模块进行创建超级群频道。
2. Server Api 调用详情请参考创建频道文档。

24418

用户组数量超出限制。

排查建议：请检查该超级群下用户组数量。默认最多 50 个。

24419

重复的用户组 ID 。

排查建议：请检查入参中的用户组 ID 是否重复。

24420

用户组不存在。

排查建议：请确认该超级群下是否存在该用户组，入参中的超级群 ID 、用户组 ID 等是否填写正确。

24421

用户组成员数量超出限制。

排查建议：请检查该超级群用户组中的成员数量。默认最多 100 个用户。

24422

频道绑定的用户组数量超出限制。

排查建议：请检查该超级群频道绑定的用户组数量。默认单个频道最多支持与 10 个用户组绑定。

25101

撤回消息参数无效，请确认撤回消息参数是否正确的填写。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID ，问题发生时间等。

25102

未开通单群聊云存储服务。

排查建议：可在融云控制台 > 应用配置 > IM 服务 > IM 服务管理开通单群聊云存储服务。

25104

未知异常。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID ，问题发生时间等。

25107

IMLib 撤回消息可以撤回自己发送的消息和别人发送的消息，IM 服务有开关，控制只可以撤回自己发送的消息，当服务该开关打开时，撤回别人的消息会报这个错误。

排查建议：

1. 默认 IMLib SDK 撤回消息时，可任意撤回其他用户发送的消息，【IMLib SDK 只允许撤回自己发送的消息】开启后只能撤回自己发送的消息，该服务需要提交工单与我们联系。
2. 通过 Server API 撤回消息时不做判断处理可撤回所有消息。

25404

非法操作，非群主修改群权限相关，msg 中返回传的对应的key。

排查建议：只有群主才有权限进行操作，可通过批量查询群组资料确认群主 ID 。

25405

没有权限操作

排查建议：可通过批量查询群组资料确认群的操作权限（permissions字段）。

25409

群组 ID 已存在。

排查建议：群组 ID 已经创建过，不需要重新创建。

25410

群 ID 不存在。

排查建议：群组 ID 不存在，可按需创建，详情参阅创建群组。

25411

群成员超限。

排查建议：

1. 邀请用户加入群组一次最多允许 30 个。
2. 群组总人数最大不超过 3000。

25412

群成员 ID 已在当前群组中。

排查建议：该用户已成功加入群组，无须再次执行邀请或者加入的操作。

25414

不允许任何人加入，无法加入群组。

排查建议：可通过批量查询群组资料确认群的操作权限（permissions字段）。

25415

扩展信息 Key 值不存在。

排查建议：可以在融云控制台 > 应用配置 > IM 服务 > 信息托管服务 > 群组自定义属性添加。

25416

查询频率超限。

排查建议：群托管 > 用户查询相关接口限制频率，默认 5 次/s，当前只限制 web 端。

25417

群主不能被踢出/退出群组。

排查建议：可通过获取指定群成员信息来确认该用户是否为群主。

25418

用户 ID 不在群组中。

排查建议：可通过获取指定群成员信息来确认该用户是否在群组中。

25419

管理员/关注 人数超过上限。

排查建议：

1. 群管理人数最大值为 20。
2. 关注人数最大值为 200。
3. 群人数最大值为 3000。

25420

该用户不是当前群的管理员。

排查建议：业务层可按需设置群管理员。

25421

无对应群 ID 和用户 ID 的邀请请求。

排查建议：

1. 邀请信息只保存 7 天，请检查邀请时间是否超过了有效期。
2. 请检查是否有发起邀请，业务层可按需重新邀请他人加入群组。

25422

查询群信息个数超限。

排查建议：

1. 查询群信息一次最多查 20 个。
2. 查询群成员一次最多查 100 个。

25423

群名称不能为空。

排查建议：详情请参阅创建群组文档。

25424

申请进群需要等待管理员审批。

排查建议：可通过批量查询群组资料确认群的操作权限（permissions字段）。

25425

群主不支持设置为管理员。

排查建议：可通过获取指定群成员信息来确认该用户在群中身份。

25426

邀请人进群时没有权限。

排查建议：

1. 可通过批量查询群组资料确认群的操作权限（permissions字段）。
2. 可通过获取指定群成员信息来确认该用户在群中身份。

25427

邀请进群需要被邀请人同意。

排查建议：可通过批量查询群组资料确认群的操作权限（permissions 字段）。

25428

请求已被其他管理员处理。

排查建议：业务层可按需提示处理。

25429

老的群不支持调用托管接口，需要导入后才能调用。

排查建议：详情请参阅群组托管导入。

25430

群 ID 不合法，包含特殊字符。

排查建议：修改群 ID ，确保其只包含英文字母和数字。

25432

pagetoken 解析失败。

排查建议：请检查 pagetoken 是否正确，并且是否为上次请求结果返回的 pagetoken。

25460

已经互为好友，操作无效。

排查建议：可通过获取用户好友列表确认是否互为好友。

25461

待对方同意后才能加为好友。

排查建议：可通过两个维度设置添加好友权限，分别是 App key 级和用户级

1. App key 级：可通过融云控制台 > 应用配置 > IM 服务 > 信息托管服务- 功能设置好友功能配置进行设置【添加好友权限设置】。
2. 用户级：可通过客户端方法设置加好友权限。

25462

在目标用户黑名单中，不能添加好友。

排查建议：业务层可按需移除黑名单中用户。

25463

不在目标用户白名单中，不能添加好友。

排查建议：用户开启了白名单功能，需要被目标用户加入白名单才可以添加好友，详情请参阅用户白名单服务。

25464

目标用户在当前用户黑名单中，不能添加好友。

排查建议：业务层可按需移除黑名单中用户。

25465

不在当前用户白名单中，不能添加好友。

排查建议：用户开启了白名单功能，需要将目标用户加入白名单才可以添加好友，详情请参阅用户白名单服务。

25466

操作无效，该好友请求不存在或已经过期。

排查建议：请检查传入的用户 ID 是否正确，好友请求有效期为 7 天，请注意是否过了有效期。

25467

当前用户好友数超出上限。

排查建议：好友最大数为 3000，可通过获取用户好友列表查看用户好友总数。

25468

目标用户好友数超出上限。

排查建议：好友最大数为 3000，可通过获取用户好友列表查看用户好友总数。

25469

非好友关系，不能执行此操作。

排查建议：请检查好友关系。

25470

好友自定义属性超出上限。

排查建议：好友自定义属性最多允许设置 10 个。

25471

对方设置了不允许加为好友。

排查建议：详情请参阅查询添加好友验证等级。

25472

好友不存在。

排查建议：用户 ID 不存在，需先注册用户。

25473

不能添加自己为好友。

排查建议：

1. Server Api 请检查接口传入的 user ID 与 target ID ，两者不能一致。
2. 客户端接口请检查传入的 user ID ，需要与当前连接融云服务的用户 ID 两者不能一致。

26001

用户级设置服务 请求参数不合法。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID ，调用的具体接口和参数等。

26002

表示客户端版本号低，需要同步版本号，可以提交工单申请打开用户级别配置开关。

排查建议：请提交工单申请打开用户级别配置开关。

26003

服务内部错误。

排查建议：请提交工单与我们联系。

26020

未开启在线状态订阅功能。

排查建议：可在融云控制台 > 应用配置 > IM 服务 > IM 服务管理开通客户端用户在线状态订阅功能。

26021

用户被订阅量达到上限，详细查看开发文档。

排查建议：用户被订阅最大值为 5000。

26022

订阅用户数达到上限，详细查看开发文档。

排查建议：用户订阅最大值为 5000。

28400

消息文本翻译服务未开通。

排查建议：可在融云控制台 > 应用配置 > AI 服务 > 翻译服务 开通翻译功能。

28401

翻译失败。

排查建议：请提交工单与我们联系。

28402

翻译服务内部异常。

排查建议：请提交工单与我们联系。

28403

请求翻译服务缺少必须参数。

排查建议：请参阅文本翻译，确认参数是否填写正确。

28404

请求翻译服务参数不合法。

排查建议：请参阅文本翻译，确认参数是否填写正确。

28405

使用翻译服务额度超限。

排查建议：请确认是否还有使用额度。

28406

翻译内容长度超限。

排查建议：请参阅文本翻译，确认请求文本内容是否超限。

28407

要翻译的目标语言不支持误。

排查建议：支持的语言详见翻译语言代码列表。

29001

拉流接口 stopReason 字段，服务端拉流时还不完整，请稍后拉取。

排查建议：请稍后拉取。

29002

流不存在

排查建议：流不存在，请确认 messageUID 是否正确。

29003

拉取超时30秒无数据结束

排查建议：续流超时截断

29004

发送流超出30分钟截断

排查建议：请确保流在 30 分钟内发完.

29005

流数据审核不过被删除

排查建议：对审核有疑问可提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID ，流消息ID等。

29006

流数据大于 128 k 截断

排查建议：不支持大于 128 k 的流数据.

29007

拉流服务内部异常

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID ，调用的具体接口和参数等。