状态码

HTTP 状态码

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

业务返回码

400

N/A

用户id 不存在

排查建议：

404

N/A

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

排查建议：

1000

N/A

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

排查建议：

1001

N/A

App Key 与 App Secret 不匹配

排查建议：

1002

N/A

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

排查建议：

1003

N/A

聊天室id 不能为空, 或者minute 参数不合法

排查建议：

1005

N/A

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

排查建议：

1006

N/A

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

排查建议：

1007

N/A

Ip 限制，访问被禁止

排查建议：

1008

N/A

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

排查建议：

1009

N/A

未开通该服务，请到开发者管理后台开通或提交工单申请

排查建议：

1010

N/A

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

排查建议：

1011

N/A

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

排查建议：

1015

N/A

删除的数据不存在

排查建议：

1016

N/A

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

排查建议：

1018

N/A

实时音视频服务未开启

排查建议：

1050

N/A

内部服务超时

排查建议：

2007

N/A

注册用户数量超限

排查建议：

20106

RESP_CODE_FB_PERSON

在单聊中已被禁言

排查建议：

20107

N/A

单聊黑名单人数超限

排查建议：

20108

N/A

单聊白名单人数超限

排查建议：

20109

illegalObjectName

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

排查建议：

20604

N/A

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

排查建议：

20605

N/A

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

排查建议：

20606

N/A

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

排查建议：

20607

N/A

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

排查建议：

21501

N/A

发送的消息中包含敏感词 （发送方发送失败，接收方不会收到消息）

排查建议：

21502

N/A

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

排查建议：

22201

N/A

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

排查建议：

22202

N/A

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

排查建议：

22203

N/A

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

排查建议：

22204

N/A

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

排查建议：

22406

N/A

不在该群组中

排查建议：

22408

N/A

在群组中已被禁言。

排查建议：

23406

N/A

不在该聊天室中。

排查建议：

23407

N/A

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

排查建议：

23408

N/A

在该聊天室中已被禁言

排查建议：

23409

N/A

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

排查建议：

23410

N/A

聊天室不存在

排查建议：

23411

N/A

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

排查建议：

23412

N/A

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

排查建议：

23413

N/A

查询聊天室历史消息异常

排查建议：

23414

N/A

聊天室云存储业务未开通

排查建议：

23423

N/A

聊天室的 KV 属性个数超限，单个聊天室默认上限为 100 个

排查建议：

23424

N/A

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

排查建议：

23425

N/A

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

排查建议：

23426

N/A

聊天室属性自定义设置，您可以在开发者后台免费基础功能页面中开启该功能。

排查建议：

23427

N/A

聊天室属性不存在

排查建议：

23428

N/A

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

排查建议：

23429

N/A

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

排查建议：

23431

N/A

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

排查建议：

23437

N/A

加入聊天室附加信息长度超限，默认最大长度为 128 个字符，服务可配置

排查建议：

24001

HAVNODEVICEID

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

排查建议：

24002

DEVICEIDISHAVE

device Id 已经存在

排查建议：

24009

FEILD

没有对应的用户或 token

排查建议：

24015

INTERNALERRROR

服务器内部错误

排查建议：

24353

N/A

重复注销

排查建议：

24354

N/A

重复激活

排查建议：

24356

N/A

用户注销中

排查建议：

24360

N/A

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

排查建议：

24361

N/A

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

排查建议：

24362

N/A

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

排查建议：

24363

N/A

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

排查建议：

24364

N/A

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

排查建议：

24365

N/A

批量查询用户托管资料的数量超过了可以查询的上限 100 个

排查建议：

24366

N/A

没有此用户

排查建议：

24367

N/A

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

排查建议：

24368

N/A

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

排查建议：

24369

N/A

未开启用户信息托管功能

排查建议：

24401

N/A

超级群功能未开通

排查建议：

24402

N/A

超级群服务异常

排查建议：

24403

N/A

超级群参数错误

排查建议：

24404

N/A

超级群未知异常

排查建议：

24406

N/A

非超级群成员

排查建议：

24408

N/A

超级群成员禁言

排查建议：

24410

N/A

超级群不存在

排查建议：

24411

N/A

超级群成员超限制

排查建议：

24412

N/A

用户加入超级群数量超限

排查建议：

24413

N/A

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

排查建议：

24414

N/A

超级群频道 ID 不存在

排查建议：

24415

N/A

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

排查建议：

24416

N/A

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

排查建议：

24418

N/A

用户组数量超出限制

排查建议：

24419

N/A

重复的用户组 ID

排查建议：

24420

N/A

用户组不存在

排查建议：

24421

N/A

用户组成员数量超出限制

排查建议：

24422

N/A

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

排查建议：

25101

N/A

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

排查建议：

25102

N/A

未开通单群聊云存储服务

排查建议：

25104

UNKNOW_ERROR_CODE

未知异常

排查建议：

25107

N/A

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

排查建议：

25402

G_SERVER_ERROR

托管服务异常

排查建议：

25403

G_PARAM_ERROR

托管服务参数错误

排查建议：

25404

G_ILLEGAL_OPERATION

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

排查建议：

25405

G_AUTHORITY_ERROR

没有权限操作

排查建议：

25406

G_PARAMETER_LENGTH_EXCEEDED_LIMIT

参数异常，存在长度超限

排查建议：

25407

G_PARAMETER_FORMATTING_ERROR

参数异常，非法字符

排查建议：

25408

G_PARAMETER_NOT_NUMBER

参数值必须是数字

排查建议：

25409

G_ID_ALREADY_EXISTS

群组 ID 已存在

排查建议：

25410

G_ID_NOT_EXISTS

群 ID 不存在

排查建议：

25411

G_MEMBERS_EXCEED_LIMIT

群成员超限

排查建议：

25412

G_MEMBERS_ALREADY_IN_GROUP

群成员 ID 已在当前群组中

排查建议：

25413

G_NOT_ALLOWED_SDK

不允许通过 SDK 进行此操作

排查建议：

25414

G_NOT_ALLOWED_JOIN_GROUP

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

排查建议：

25415

G_PROFILE_KEY_NOT_EXIST

扩展信息 Key 值不存在

排查建议：

25416

G_QUERY_FREQUENCY_EXCEEDS_LIMIT

查询频率超限

排查建议：

25417

G_OWNER_NOT_SUPPORT

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

排查建议：

25418

G_USER_NOT_IN_GROUP

用户ID不在群组中

排查建议：

25419

G_MANAGERS_OR_FOLLOWERS_EXCEEDS_LIMIT

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

排查建议：

25420

N/A

用户 ID 不在当前群管理员

排查建议：

25421

N/A

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

排查建议：

25422

N/A

查询群信息个数超限

排查建议：

25423

N/A

群名称不能为空

排查建议：

25424

N/A

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

排查建议：

25425

N/A

群主不支持设置为管理员

排查建议：

25426

N/A

邀请人进群时没有权限

排查建议：

25427

N/A

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

排查建议：

25428

N/A

管理员或群主处理请求时，别的管理员已处理

排查建议：

25429

N/A

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

排查建议：

25430

N/A

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

排查建议：

25432

N/A

pagetoken解析失败

排查建议：

25460

N/A

已经互为好友，操作无效

排查建议：

25461

N/A

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

排查建议：

25462

N/A

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

排查建议：

25463

N/A

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

排查建议：

25464

N/A

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

排查建议：

25465

N/A

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

排查建议：

25466

N/A

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

排查建议：

25467

N/A

当前用户好友数超出上限

排查建议：

25468

N/A

目标用户好友数超出上限

排查建议：

25469

N/A

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

排查建议：

25470

N/A

好友自定义属性超出上限

排查建议：

25471

N/A

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

排查建议：

25472

N/A

好友不存在

排查建议：

25473

N/A

不能添加自己为好友

排查建议：

26001

N/A

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

排查建议：

26002

N/A

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

排查建议：

26003

USER_SUBS_ERROR

服务内部错误

排查建议：

26004

REQ_LIMIT_OUT

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

排查建议：

26005

NOT_OPEN_READ_V4

未开通v4已读回执

排查建议：

26006

NOT_OPEN_SESS_DRIVEN

未开通会话驱动

排查建议：

26007

MSGID_START_END_ERROR

消息 id 顺序错误

排查建议：

26008

MSGID_EXPIRE

上报时间不支持同步

排查建议：

26009

MSGID_ERROR

消息id不合法

排查建议：

26010

PARAM_ERROR

参数有误

排查建议：

26020

SUBSCRIPTION_NOT_ACTIVATED

未开启在线状态订阅功能

排查建议：

26021

SUBSCRIBER_OUT_LIMIT

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

排查建议：

26022

SUBS_OUT_LIMIT

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

排查建议：

26106

ERROR_RESULT_CODE_FILE_EXCEEDS_SIZE_LIMIT

上传文件超过最大限制

排查建议：

26107

ERROR_RESULT_CODE_FILE_SIZE_IS_REQUIRED

开启限制未传 size 参数

排查建议：

26201

TOKEN_ERP

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

排查建议：

26202

TOKEN_ERROR

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

排查建议：

26203

GOOGLE_SERVCIE_ERROR

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

排查建议：

26204

NOT_OPEN_SERVCIE_ERROR

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

排查建议：

26206

NOT_SECRET_ERROR

翻译失败，Server 没有鉴权 token 的 sercret 需要在融云开发者后台开启

排查建议：

26208

GOOGLE_SERVCIE_SPEACH_EMPTY_ERROR

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

排查建议：

26210

PARAM_ENCODING_ERROR

编码格式设置错误

排查建议：

29102

DEFFOLLOWED

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

排查建议：

29104

DEFUNFOLLOWED

公众号默认已取消关注，针对会话类型：ConversationType_APP_PUBLIC_SERVICE。(错误码已废弃)

排查建议：

31001

N/A

信令版本错误

排查建议：

31002

N/A

客户端 info 字段格式错误，正确格式：{平台类型}-{设备信息}-{sdk版本}。 其中设备信息：{手机类型}|{手机型号}|{网络类型，4G/WIFI}|{运营商标识, 移动/电信/联通}

排查建议：

31003

N/A

连接服务未开通，需要排查后台小程序（或桌面端）服务是否已开通

排查建议：

31004

N/A

Token 无效；AppKey 和 Token 不匹配；Token 过期

排查建议：

31005

N/A

App 校验未通过（开通了 App 校验功能，但是校验未通过）

排查建议：

31006

N/A

连接重定向

排查建议：

31007

N/A

包名与后台注册信息不匹配

排查建议：

31008

N/A

AppKey 被封禁或已删除

排查建议：

31009

N/A

连接失败，用户被封禁（客户端主动连接失败返回）

排查建议：

31020

N/A

Token 已过期

排查建议：

31021

N/A

Token 中携带 deviceId 时，检测 Token 中deviceId 与链接设备 deviceId 不一致

排查建议：

31022

N/A

页面域名不在安全域名白名单内，需通过开发者后台添加安全域名配置

排查建议：

31023

N/A

开启禁止把已在线客户端踢下线开关后，该错误码标识已有同类型端在线

排查建议：

31024

N/A

连接总数量超过服务设定的并发限定值（私有云专属）

排查建议：

31025

N/A

客户端连错环境，引发连接拒绝；如使用开发环境 Appkey 连接到生产环境

排查建议：

31026

N/A

开启AppServer联合鉴权功能后，到AppServer认证失败

排查建议：

31027

N/A

该 token 已经被使用过,无法进行连接 一次性 token 只能连接一次，之后再使用会上报此错误

排查建议：

31028

N/A

Token 平台验证失败

排查建议：

31029

N/A

用户已销户

排查建议：

31030

N/A

私有云 License 检查不通过;APP License 过期

排查建议：

状态码	描述	详细解释
404	未找到	服务器找不到请求的地址（HTTP 状态码 404）
1000	服务内部错误	服务器端内部逻辑错误,请稍后重试（HTTP 状态码 500）
1001	App Secret 错误	App Key 与 App Secret 不匹配（HTTP 状态码 401）
1002	参数错误	参数错误，详细的描述信息会说明（HTTP 状态码 400）
1003	无 POST 数据	没有 POST 任何数据（HTTP 状态码 400）
1004	验证签名错误	验证签名错误（HTTP 状态码 401）
1005	参数长度超限	参数长度超限，详细的描述信息会说明（HTTP 状态码 400）
1006	App 被锁定或删除	App 被锁定或删除（HTTP 状态码 401）
1007	被限制调用	该方法被限制调用，详细的描述信息会说明（HTTP 状态码 401）
1008	调用频率超限	调用频率超限。注意，即使未开通 API 相关服务，如果连续请求导致 API 调用频率超限，也会触发该错误。（HTTP 状态码 429）
1009	服务未开通	未开通该服务，请到开发者管理后台开通或提交工单申请。（HTTP 状态码 430）
1010	服务未开通	未开通白名单服务，请到开发者管理后台开通或提交工单申请。（HTTP 状态码 430）
1011	服务未开通	未开通黑名单服务，请到开发者管理后台开通或提交工单申请。（HTTP 状态码 430）
1015	删除的数据不存在	要删除的保活聊天室 ID 不存在。（HTTP 状态码 200）
1016	设置保活聊天室个数超限	设置的保活聊天室个数超限。（HTTP 状态码 403）
1017	实时音视频 SDK 版本不支持	音视频 SDK 版本不支持，请使用 2.9.0 及之后的实时音视频 SDK。
1018	实时音视频服务未开启	未开启服务，请到开发者管理后台开通实时音视频服务。（HTTP 状态码 403）
1050	内部服务超时	内部服务响应超时（HTTP 状态码 504）
2007	注册用户数量超限	开发环境下注册用户上限为 100 个，生产环境未开通 IM 付费版本时可免费注册 100个，超过后需要升级到付费版本，私有部署客户请联系商务；单独使用音视频服务没有注册用户数限制，如您单独使用音视频服务触发了该错误，请检查您的音视频服务是否因欠费或其它原因处于关停状态。
20107	单聊黑名单人数超限	调用「添加用户到黑名单」接口，用户 ID 的黑名单人数已达到上限（3000 ），返回该错误码。
20108	单聊白名单人数超限	调用「添加用户到白名单」接口，用户 ID 的白名单人数已达到上限（3000 ），返回该错误码。
23407	聊天室禁言白名单人数超限	单次 API 请求中聊天室中禁言白名单用户已达到上限（20 个），返回该错误码。请分次添加禁言白名单用户。
23423	聊天室属性超限	单个聊天室最多设置 100 个属性 KV。如果超过个数上限，当前请求设置的属性全部设置失败，返回该错误码和当前已有的属性数量。
23426	聊天室属性功能未开通	聊天室自定义属性未开通时，返回该错误码。
23410	聊天室不存在	聊天室不存在。
23432	聊天室销毁时间不合法	设置聊天室销毁时间（分钟）非有效值时，返回该错误码。有效值为 [60 - 10080] 的整数。
23433	聊天室销毁类型不合法	设置聊天室销毁类型非有效值时，返回该错误码。有效值请参见文档中定义的类型对应值。
23434	聊天室属性无对应用户 ID	如果设置聊天室自定义属性，必须同时传用户 ID，否则返回该错误码。
23435	聊天室已存在	创建聊天室时聊天室已存在，返回该错误码。
23436	聊天室存活时长无效	为定时销毁的聊天室设置存活时长时，应保证传入的存活时长大于聊天室自创建后的已存活时长，否则返回该错误码。
24353	重复注销	调用注销接口，传入已完成注销的用户 ID 时，返回该错误码。
24354	重复激活	调用重新激活用户 ID 的接口，传入已激活的用户 ID 时，返回该错误码。
24356	用户注销中	调用注销接口，传入正在注销流程中的用户 ID 时，返回该错误码。
24410	超级群不存在	未找到超级群，请先进行创建
24412	用户加入超级群数量超限	用户加入超级群数量超限，每个用户最多可加入 100 个超级群。
24413	频道数超出上限	该超级群下创建的频道数超限，每个超级群下默认可创建 50 个频道。
24414	超级群频道 ID 不存在	请确认该超级群下存在该频道。
24416	发送者不在超级群私有频道成员列表中	请确认该超级群下该私有频道的成员列表中是否包含该用户 ID，或者发送消息的频道 ID 是否填写正确。
24418	用户组数量超出限制	请检查该超级群下用户组数量。默认最多 50 个。
24419	重复的用户组 ID	请检查入参中的用户组 ID 是否重复。
24420	用户组不存在	请确认该超级群下是否存在该用户组，入参中的超级群 ID、用户组 ID 等是否填写正确。
24421	用户组成员数量超出限制	请检查该超级群用户组中的成员数量。默认最多 100 个用户。
24422	频道绑定的用户组数量超出限制	请检查该超级群频道绑定的用户组数量。默认单个频道最多支持与 10 个用户组绑定。