状态码

HTTP 状态码

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

业务返回码

400

用户 ID 不存在。

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

404

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

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

405

已被对方加入黑名单，消息发送失败。

排查建议：可根据业务需求将用户移出黑名单，请参阅移除黑名单中用户。

407

对方开启了只接收白名单的信息，但己方不在白名单中，发送消息失败。

排查建议：将己方添加到接收方的白名单中

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 个。可按控制台内嵌指南嵌入用户管理页面（page_code: user_manage）后，在自己的管理后台中删除用户。
2. 单独使用音视频服务没有注册用户数限制，如您单独使用音视频服务触发了该错误，请检查您的音视频服务是否因欠费或其它原因处于关停状态。
3. 注销的用户也占用用户数量并且在融云控制台看不到，需要重新激活用户再删除。

20106

在单聊中已被禁言。

排查建议：可根据业务需求取消用户禁言，详情请参阅设置用户单聊禁言。

20107

单聊黑名单人数超限。

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

20108

单聊白名单人数超限。

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

20109

系统会话不支持发送该消息类型。

排查建议：系统会话只允许发送 RC:SRSMsg 类型消息，其它消息类型暂不支持发送。

20112

消息内容存在敏感词。

排查建议：修改的消息内容命中了敏感词，可以查看配置的敏感词。

20113

消息内容未通过审核。

排查建议：修改的消息被内容审核拦截，您可以提供一下接受者 ID，和修改时间提工单这边分析下。

20114

消息超过可修改时间。

排查建议：修改时间限制：仅支持修改消息发送后 24 小时内的消息。

20115

消息大小超出限制。

排查建议：修改后的消息内容条消息最大 128k。

20116

消息不支持修改。

排查建议：RC:StreamMsg 该消息类型不支持修改

20512

appkey 的数据中心与请求云控的数据中心不匹配。

排查建议：

1. 当您选择了国内数据中心，App 服务端集成融云服务端 API 时，必须使用国内的 API 地址。客户端集成默认连接国内数据中心。
2. 当您选择了海外的数据中心，如新加坡、北美、或沙特，App 服务端集成融云服务端 API 时，必须使用相对应的API 海外地址。
3. 您可以在融云控制台 > 应用配置 > 基本信息 > AppKey 配置页面查看您应用属于哪个数据中心。
4. 集成客户端时，您须传入相对应的区域码，或者手动设置 SDK 连接的服务器的地址。

20604

发送消息频率过高，1 秒钟最多只允许发送 5 条消息。

排查建议：建议客户端延时调用接口，防止超频导致报错。

20605

操作被禁止，此错误码已被弃用。

排查建议：此错误码已被弃用

20606

操作不支持，仅私有云有效，服务端禁用了该操作。

排查建议：只适用于私有云环境，公有云用户可忽略。

20607

请求超出了调用频率限制，请稍后再试。

排查建议：调用查询类信令超限，默认限制为 50 次/秒，请将客户端调用接口的频率控制在 50 次/秒范围内。

21406

不在讨论组。

排查建议：此错误码已被弃用

21501

发送的消息由于包含敏感词而被屏蔽，发送方无法发送消息。

排查建议：

1. 请检查后台的敏感词配置，路径为：融云控制台 > 应用配置 > 安全&审核 > 敏感词设置。
2. 过滤方式为屏蔽消息。
3. 业务层可按需删除敏感词或者发送不包含敏感词的消息。

21502

消息中敏感词已经被替换，接收方可以收到被替换之后的消息。

排查建议：

1. 请检查后台的敏感词配置，路径为：融云控制台 > 应用配置 > 安全&审核 > 敏感词设置。
2. 过滤方式为替换敏感词。
3. 业务层可按需删除敏感词或者发送不包含敏感词的消息。

22201

设置扩展消息，但是原始消息不存在。

排查建议：

1. 超级群历史消息默认存储 7 天，超过 7 天的消息会被删除
2. 单群聊历史消息默认存储 180 天，超过 180 天的消息会被删除
3. 原消息可能已经被手动删除，可通过获取超级群会话历史消息和获取单群聊会话历史消息确认原消息是否存在。

22202

设置扩展消息，但是原始消息不支持扩展。

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

22203

设置扩展消息，扩展内容格式错误。

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

22204

设置扩展消息，无操作权限。

排查建议：

1. 修改超级群扩展时传入的会话类型参数错误，请检查传入的会话类型值是否为 10。
2. 修改超级群消息时，请检查是否为超级群消息发送人。

22406

不在该群组中。

排查建议：

1. 需先按控制台内嵌指南嵌入到管理后台的 IM Server API 调试页面（page_code: im_server_api）中，进入超级群模块进行查询，加入等动作。
2. 如果用户在群组中，但服务端仍返回该错误，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，群组ID，问题发生时间等。

22408

在群组中已被禁言。

排查建议：业务层可按需取消群组/超级群禁言，详情请参阅群组禁言服务/超级群禁言服务。

23406

不在该聊天室中。

排查建议：

1. 可按控制台内嵌指南嵌入 IM Server API 调试页面（page_code: im_server_api）后，在聊天室模块进行查询、加入等动作。
2. 聊天室具有自动销毁机制和离线成员自动退出机制，触发上述机制也会导致用户不在聊天室中，您可以在聊天室状态同步中获取到详细信息。
3. 如果用户在聊天室中，但服务端仍返回该错误，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，聊天室ID，问题发生时间等。

23407

聊天室禁言白名单人数超限。

排查建议：

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

23408

在该聊天室中已被禁言。

排查建议：

1. 禁言状态分为：设置聊天室全体禁言，全局禁言用户，禁言指定聊天室用户
2. 业务层可按需根据上述禁言状态取消聊天室全体禁言，取消全局禁言用户，取消禁言指定聊天室用户

23409

已被踢出并禁止加入聊天室。被禁止的时间取决于服务端调用踢出接口时传入的时间。

排查建议：业务层可按需解除封禁，详情请参阅解除封禁聊天室用户

23410

聊天室不存在。

排查建议：

1. 聊天室具有自动销毁机制和离线成员自动退出机制，详情请参阅聊天室销毁机制和退出聊天室文档，业务层可观察一下是否因为上述机制导致。
2. 也可在需先按控制台内嵌指南嵌入到管理后台的 IM Server API 调试页面（page_code: im_server_api）中，进入聊天室模块进行查询，创建等动作。

23411

聊天室成员超限，开发者可以提交工单申请聊天室人数限制变更。

排查建议：

1. 聊天室业务默认成员无上限，但也可配置上限，请先确认是否配置过聊天室成员上限。
2. 如需调整聊天室成员上限，请提交工单与我们联系。

23412

聊天室接口参数无效。请确认参数是否为空或者有效。

排查建议：

1. 请根据接口文档检查参数是否为空或者有效。
2. 检查参数后仍无法解决问题，请提交工单与我们联系，并附上必要的的信息，如接口名称，接口参数，问题发生时间等。

23413

查询聊天室历史消息异常。

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

23414

聊天室云存储业务未开通。

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

23423

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

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

23424

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

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

23425

【已废弃】超过聊天室中状态设置频率，1 个聊天室 1 秒钟最多设置和删除状态 100 次。

排查建议：该错误码服务端已废弃

23426

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

排查建议：需先按控制台内嵌指南嵌入到管理后台的 IM 服务功能配置页面（page_code: im_service_config）中，进入 聊天室 > 聊天室属性自定义设置，开通此功能。

23427

聊天室属性不存在。

排查建议：

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

23428

聊天室批量设置或删除 KV 部分不成功。

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

23429

聊天室批量设置或删除KV数量超限（最多一次10条）。

排查建议：数量范围在 1-10 条之间，该范围无法调整。

23431

【已废弃】聊天室设置 KV 失败，出现在两人或者多端同时操作一个 KV。 如果出现该错误，为避免和其他端同时操作，请延时一定时间再试。

排查建议：该错误码已废弃

23432

聊天室销毁时间不合法。

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

23433

聊天室销毁类型不合法。

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

23434

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

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

23435

聊天室已存在。

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

23436

聊天室存活时长无效。

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

23437

加入聊天室附加信息长度超限。

排查建议：服务端可配置，默认最大长度为 128 个字符。

24001

没有注册 DeviveId 也就是用户没有登陆。

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

24002

device Id 已经存在。

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

24009

没有对应的用户或 token。

排查建议：

1. 请检查用户是否已经注册。可按控制台内嵌指南嵌入用户管理页面（page_code: user_manage）后，在自己的管理后台中验证 token 是否有效。
2. 建议按控制台内嵌指南嵌入 IM Server API 调试页面（page_code: im_server_api）后，重新获取一个 token 验证连接

24015

服务器内部错误。

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

24353

重复注销。

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

24354

重复激活。

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

24356

用户注销中。

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

24360

没有设置该用户托管属性的权限。

排查建议：

1. 客户端不允许设置 uniqueId 参数，请检查是否在调用 updateMyUserProfile 接口时设置了 uniqueId 参数。
2. 如果有设置 uniqueId 的需求，可调用 Server Api 进行设置，详情请参阅设置用户信息。

24361

用户托管基本属性的 key 列表中没有此 key。

排查建议：修改用户托管信息的 key 不存在，详情请参阅设置用户信息。

24362

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

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

24363

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

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

24364

用户托管基本属性或扩展属性的 Value，字符超过最大上限。

排查建议：Value 的最大长度为 256 个字符。

24365

批量查询用户托管资料的数量超限。

排查建议：

1. 客户端一次最多可查询 20 个用户。
2. 使用 Server Api 调用一次最多可查询 100 个用户。详情请参阅批量查询用户资料。

24366

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

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

24367

用户托管此属性 Value 只能是数字。

排查建议：性别、角色、级别必须 Int 类型，详情请参阅设置用户信息。

24368

用户托管此属性 Value 值超过设置取值范围。

排查建议：更新用户信息时，Value 值不能超过设置的取值范围，详情请参阅更新当前用户信息。

24369

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

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

24401

超级群功能未开通。

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

24402

超级群服务异常。

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

24403

超级群参数错误。

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

24404

超级群未知异常。

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

24406

非超级群成员。

排查建议：可在需先按控制台内嵌指南嵌入到管理后台的 IM Server API 调试页面（page_code: im_server_api）中，进入超级群模块进行查询，加入等动作。

24408

超级群成员被禁言。

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

24410

超级群不存在。

排查建议：需先按控制台内嵌指南嵌入到管理后台的 IM Server API 调试页面（page_code: im_server_api）中，进入超级群模块进行创建。

24411

超级群成员超限制。

排查建议：保留字段， server 端暂未使用

24412

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

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

24413

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

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

24414

超级群频道 ID 不存在。

排查建议：

1. 业务层可按需在控制台内嵌指南嵌入到管理后台的 IM Server API 调试页面（page_code: im_server_api）中，进入超级群模块进行创建超级群频道。
2. Server Api 调用详情请参考创建频道文档。

24415

超级群频道发送消息超限。

排查建议：超级群下每个频道有消息发送频率限制，默认每秒 20 条，频道内每秒发送消息总量超过限制会收到该错误码，建议延时发送或重试发送。

24416

用户不在超级群私有频道中。

排查建议：业务层可按需添加私有频道成员。

24418

用户组数量超出限制。

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

24419

重复的用户组 ID 。

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

24420

用户组不存在。

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

24421

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

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

24422

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

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

24501

Manage device function is not supported

排查建议：

没开启服务端 multiDeviceSwitch 开关。（此配置默认开启而且没有修改入口，一般不会出现这个报错）

24502

The request parameter is incorrect

排查建议：检查调用参数。查询接口建议 size 传 1-100，status 只传 0/1 或不传；删除设备至少传 platforms 或 deviceIds 其中一个，且数量不超过 100。

25101

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

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

25102

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

排查建议：可在融云控制台 IM 服务的服务购买页面开通单群聊消息云端存储服务。

25104

未知异常。

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

25107

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

排查建议：

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

25108

批量列表长度超出限制。

排查建议：批量列表长度超出 100 限制

25402

托管服务异常。

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

25403

托管服务参数错误。

排查建议：

1. 请检查用户信息托管相关接口传入参数是否符合文档要求。
2. 如有疑问，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，调用的具体接口和参数等。

25404

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

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

25405

没有权限操作。

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

25406

参数异常，存在长度超限。

排查建议：

1. 请根据接口文档检查参数是否有效，参数长度是否超过限制。
2. 如果参数有效，仍出现该问题，需提供对应接口和参数信息，提交工单与我们联系。

25407

参数异常，非法字符。

排查建议：群组属性内置的 key 不存在。

25408

参数值必须是数字。

排查建议：

1. 请根据接口文档检查参数是否有效，参数必须为数字。
2. 如果参数有效，仍出现该问题，需提供对应接口和参数信息，提交工单与我们联系。

25409

群组 ID 已存在。

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

25410

群 ID 不存在。

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

25411

群成员超限。

排查建议：

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

25412

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

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

25413

不允许通过 SDK 进行此操作。

排查建议：该属性不允许客户端进行修改，可以在融云控制台 > 应用配置 > IM 服务 > 信息托管服务 > 群组自定义属性查看。

25414

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

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

25415

扩展信息 Key 值不存在。

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

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 服务功能配置页面（page_code: im_service_config）中，进入好友 > 添加好友权限设置进行设置。
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

服务内部错误。

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

26004

用户会话标签个数超限，最多支持添加 20 个标签。

排查建议：最多支持添加 20 个标签

26005

未开通 v4 已读回执。

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

26006

未开通会话驱动。

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

26007

消息 ID 顺序错误。

排查建议：请检查 StartMsgId 和 EndMsgId 参数，需保证 StartMsgId 时间不能小于 EndMsgId 时间。

26008

上报时间不支持同步。

排查建议：消息已经过期，该时间不能超过 30 天。

26009

消息 ID 不合法。

排查建议：请检查传入的的 messageUid 参数。

26010

参数有误。

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

26020

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

排查建议：可在融云控制台 IM 服务的服务购买页面开通客户端用户在线状态订阅功能。

26021

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

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

26022

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

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

26030

标签不存在。

排查建议：操作的标签不存在，检查是否传错标签，或者标签没创建，可以通过服务端查看会话标签

26101

小视频服务未开通。可以在融云开发者后台中开启该服务。(已经不需要开通)

排查建议：该服务已自动开通，不需要在手动开通，如果还是出现，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID。

26106

上传文件超过最大限制。

排查建议：文件上传最大限制为 100 MB。

26107

开启限制未传 size 参数。

排查建议：上传文件时，需传 size 参数，单位为 KB。

26200

翻译成功。

排查建议：返回成功。

26201

翻译失败，融云鉴权失败或者 token 过期。

排查建议：翻译失败，融云鉴权失败或者 token 过期，或者 token 为空，请重新获取鉴权 token。

26202

翻译失败，翻译功能服务商鉴权失败 融云服务器的原因，token 无效。

排查建议：翻译失败，融云鉴权失败 鉴权失败或者 token 过期，或者 token 为空，请重新获取鉴权 token。

26203

翻译失败，翻译功能服务商返回失败，具体看服务商失败码信息。

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

26204

翻译失败，翻译功能未在融云开启。

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

26206

翻译失败，Server 没有鉴权 token 的 secret 需要在融云融云控制台开启。

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

26208

短语音转录结果为空，请核对编解码类型。

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

26209

语言设置错误。(语音转文字，目前没上线)。

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

26210

编码格式设置错误。

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

26320

非消息发送者。

排查建议：不是该用户发的消息，辛苦检查一下消息的发送者。

26323

消息回应数量超出限制

排查建议：

含义：单条消息上的 Reaction 类型数量超过限制。

• 触发原因：给同一条消息添加一个新的 reactionId 时，系统会先看这条消息当前已有多少种不同的 reaction。如果已有 reaction 类型数已经达到应用配置上限 msgReactionCnt，再新增一种 reaction 类型就返回 26323。
• 默认上限：一条消息最多添加50个 reaction 。

26324

消息回应人数超出限制

排查建议：

• 含义：某一种 Reaction 下的用户数量超过限制。
• 触发原因：给同一条消息的同一个 reactionId 添加用户时，系统会看该 reaction 下已有多少用户。如果用户数已经达到应用配置上限 msgReactionUserCnt，再有新用户添加同一个 reaction 就返回 26324。
• 默认上限：用户数上限 100。

28400

智能文本翻译服务未开通。

排查建议：可在融云控制台智能文本翻译页面开通服务。

28401

翻译失败。

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

28402

翻译服务内部异常。

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

28403

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

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

28404

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

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

28405

使用翻译服务额度超限。

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

28406

翻译内容长度超限。

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

28407

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

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

29001

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

排查建议：请稍后拉取。

29002

流不存在。

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

29003

拉取超时30秒无数据结束。

排查建议：续流超时截断

29004

发送流超出30分钟截断。

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

29005

流数据审核不过被删除。

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

29006

流数据大于 128k 截断。

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

29007

拉流服务内部异常。

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

29102

【已废弃】(MP)公众号默认已关注，针对会话类型：ConversationType_APP_PUBLIC_SERVICE。

排查建议：公众号 默认是关注的, 不需要再次关注

29103

【已废弃】(MP)公众号已关注，针对会话类型：ConversationType_APP_PUBLIC_SERVICE。

排查建议：用户已经关注过该公众号, 不用再次关注。

29104

【已废弃】公众号默认已取消关注，针对会话类型：ConversationType_APP_PUBLIC_SERVICE。

排查建议：已废弃未使用。

29105

【已废弃】(MP)公众号已经取消关注，针对会话类型：ConversationType_APP_PUBLIC_SERVICE。

排查建议：需要先关注才能发消息。

29106

【已废弃】(MP)未关注此公众号，针对会话类型：ConversationType_APP_PUBLIC_SERVICE。

排查建议：没有关注此公众号, 所以无法取消关注。

29201

【已废弃】无效的公众号。(由会话类型和 Id 所标识的公众号会话是无效的)。针对会话类型：ConversationType_PUBLIC_SERVICE。

排查建议：公众号不存在，请使用正常的公众号。

29202

【已废弃】公众号默认已关注，针对会话类型：ConversationType_PUBLIC_SERVICE。

排查建议：此公众号默认是关注的，无法取消关注。

29203

【已废弃】公众号已关注，针对会话类型：ConversationType_PUBLIC_SERVICE。

排查建议：已废弃未使用。

29204

【已废弃】公众号默认已取消关注，针对会话类型：ConversationType_PUBLIC_SERVICE。

排查建议：已废弃未使用

29205

【已废弃】公众号已经取消关注，针对会话类型：ConversationType_PUBLIC_SERVICE。

排查建议：已经取消关注 所以无法发消息。如需发消息，请重新关注。

29206

【已废弃】公众号未关注，针对会话类型：ConversationType_PUBLIC_SERVICE。

排查建议：没有关注此公众号，所以无法取消关注。

40131

RTC 服务过期。

排查建议：音视频 license 到期，私有云管理后台不做展示，需要去 dcp 系统里面确认。