tencent cloud

文档反馈

错误码

最后更新时间:2024-11-11 14:59:21

    (一)IM SDK 的错误码

    说明
    Web SDK 相关的错误码请参见 错误码对照表

    通用错误码

    错误码
    描述
    4001
    文件消息失败,对应 URL 不是 IM 分配的存储资源。
    4002
    文件消息失败,内部服务器网络错误。
    4003
    图片消息失败,数据万象返回格式错误。
    4004
    图片消息失败,无效的图片格式。
    4005
    文件消息失败,禁止发送违规封禁的文件。
    6015
    执行中,请做好接口调用控制。例如,第一次初始化操作在回调前,后续的初始化操作会返回该错误码。
    6017
    参数无效,请检查参数是否符合要求,具体可查看错误信息进一步定义哪个字段。
    6022
    操作本地 IO 错误,检查是否有读写权限,磁盘是否已满。
    6027
    错误的 JSON 格式,请检查参数是否符合接口的要求,具体可查看错误信息进一步定义哪个字段。
    6028
    内存不足,可能存在内存泄漏,iOS 平台使用 Instrument 工具,Android 平台使用 Profiler 工具,分析出什么地方的内存占用高。
    6001
    PB 解析失败,内部错误。
    6002
    PB 序列化失败,内部错误。
    6013
    IM SDK 未初始化,初始化成功回调之后重试。
    6005
    加载本地数据库操作失败,可能存储文件有损坏。
    6019
    本地数据库操作失败,可能是部分目录无权限或者数据库文件已损坏。
    7001
    跨线程错误,不能在跨越不同线程中执行,内部错误。
    7002
    TinyId 为空,内部错误。请检查 UserID 是否存在并有效。
    7003
    UserID 非法,必须不为空,要求可打印 ASCII 字符(0x20-0x7e),长度不超过32字节。
    7004
    文件不存在,请检查文件路径是否正确。
    7005
    文件大小超出了限制,如果上传文件,最大限制是100MB。
    7006
    空文件,要求文件大小不是0字节,如果上传图片、语音、视频或文件,请检查文件是否正确生成。
    7007
    文件打开失败,请检查文件是否存在,或者已被独占打开,引起 SDK 打开失败。
    7008
    API 调用超频,请检查并避免高频调用接口。
    7009
    正在进行中的操作,因调用 unInitSDK 接口,被意外终止。例如正在登录中,此时调用 unInitSDK 接口,会终止登录操作。
    7010
    database 操作失败。
    7011
    database 查询的数据不存在。
    7012
    SDK 内部不应该出现的内部错误
    7013
    套餐包不支持该接口的使用,请升级到进阶版套餐。
    7014
    非法请求。请检查接口调用是否符合要求。
    7015
    SDK 本地内容审核,命中敏感词。

    账号错误码

    错误码
    描述
    6014
    IM SDK 未登录,请先登录,成功回调之后重试,或者已被踢下线,可使用 TIMManager getLoginUser 检查当前是否在线。
    6026
    自动登录时,并没有登录过该用户,这时候请调用 login 接口重新登录。
    6206
    UserSig 过期,请重新获取有效的 UserSig 后再重新登录,获取方法请参见 生成 UserSig
    6208
    其他终端登录同一个账号,引起已登录的账号被踢,需重新登录。
    7501
    登录正在执行中,例如,第一次 login 或 autoLogin 操作在回调前,后续的 login 或 autoLogin 操作会返回该错误码。
    7502
    登出正在执行中,例如,第一次 logout 操作在回调前,后续的 logout 操作会返回该错误码。
    7503
    TLS SDK 初始化失败,内部错误。
    7504
    TLS SDK 未初始化,内部错误。
    7505
    TLS SDK TRANS 包格式错误,内部错误。
    7506
    TLS SDK 解密失败,内部错误。
    7507
    TLS SDK 请求失败,内部错误。
    7508
    TLS SDK 请求超时,内部错误。

    消息错误码

    错误码
    描述
    6004
    会话无效,getConversation 时检查是否已经登录,如未登录获取会话,会有此错误码返回。
    6006
    文件传输鉴权失败,建议检查文件格式是否正确。
    6007
    文件传输获取 Server 列表失败。
    6008
    文件传输上传失败,请检查网络是否连接,如果上传的是图片,确认图片能够正常打开。
    6009
    文件传输下载失败,请检查网络,或者文件、语音是否已经过期,目前资源文件存储7天。
    6010
    HTTP 请求失败,请检查 URL 地址是否合法,可在网页浏览器尝试访问该 URL 地址。
    6016
    IM SDK 无效消息 elem,具体可查看错误信息进一步定义哪个字段。
    6021
    无效的对象,例如用户自己生成 TIMImage 对象,或内部赋值错误导致对象无效。
    6031
    文件传输上传失败,请检查上传的图片是否能够正常打开。
    6032
    无效的消息接收方,请在控制台检查消息的接收方是否存在。
    8001
    消息长度超出限制,消息长度不要超过12K,消息长度是各个 elem 长度的总和,elem 长度是所有 elem 字段的长度总和。
    8002
    消息 KEY 错误,内部错误,网络请求包的 KEY 和 回复包的不一致。
    8003
    图片转换 HTTP 请求失败。
    8004
    万象优图因为鉴黄等原因转缩略图失败。
    8005
    合并转发消息嵌套层数超过上限100层。
    8006
    消息修改冲突,您请求修改的消息已经被其他人修改。
    8010
    信令请求 ID 无效或已经被处理过。
    8011
    信令请求无权限,比如取消非自己发起的邀请。
    8012
    信令邀请已存在。
    8020
    取消消息时,取消的消息不存在,或者已经发送成功。取消失败。
    8021
    消息发送失败,因为该消息已被取消。

    群组错误码

    错误码
    描述
    8501
    群组 ID(群组唯一标识)非法,自定义群组 ID 必须为可打印 ASCII 字符(0x20-0x7e),最长48个字节,且前缀不能为 @TGS#(避免与服务端默认分配的群组 ID 混淆)。
    8502
    群名称非法,群名称最长30字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
    8503
    群简介非法,群简介最长240字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
    8504
    群公告非法,群公告最长300字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
    8505
    群头像 URL 非法,群头像 URL 最长100字节,可在网页浏览器尝试访问该 URL 地址。
    8506
    群名片非法,群名片最长50字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
    8507
    超过群组成员数的限制,在创建群和邀请成员时,指定的成员数超出限制,最大群成员数量:标准版是200人;增值服务可扩展至2000人,进阶版是2000人;增值服务可扩展至6000人,音视频聊天室和在线成员广播大群无限制。
    8508
    不允许申请加入 Private 群组,任意群成员可邀请入群,且无需被邀请人同意。
    8509
    不允许邀请角色为群主的成员,请检查角色字段是否填写正确。
    8510
    不允许邀请0个成员,请检查成员字段是否填写正确。
    8511
    群属性接口操作限制:增删改接口后台限制1秒5次,查接口 SDK 限制5秒20次。
    8512
    获取群在线人数接口操作限制:查接口 SDK 限制60秒1次。
    8513
    获取群资料接口操作限制:查接口 SDK 限制1秒1次。
    8514
    获取加入群列表接口操作限制:查接口 SDK 限制1秒1次。
    8515
    不允许标记群成员。

    关系链错误码

    错误码
    描述
    9001
    资料字段非法,资料支持标配字段及自定义字段,其中自定义字段的关键字,必须是英文字母,且长度不得超过8字节,自定义字段的值最长不能超过500字节。
    9002
    备注字段非法,最大96字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
    9003
    请求添加好友的请求说明字段非法,最大120字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
    9004
    请求添加好友的添加来源字段非法,来源需要添加“AddSource_Type_”前缀。
    9005
    好友分组字段非法,必须不为空,每个分组的名称最长30字节,字符编码必须是 UTF-8 ,如果包含中文,可能用多个字节表示一个中文字符,请注意检查字符串的字节长度。
    9006
    超过数量限制。

    网络错误码

    错误码
    描述
    9501
    SSO 加密失败,内部错误。
    9502
    SSO 解密失败,内部错误。
    9503
    SSO 未完成鉴权,可能登录未完成,请在登录完成后再操作。
    9504
    数据包压缩失败,内部错误。
    9505
    数据包解压失败,内部错误。
    9506
    调用频率限制,最大每秒发起5次请求。
    9507
    网络请求队列超过同时请求数量的最大限制,最大请求数量为1000个。例如,网络异常时仍然在不停地发消息,网络请求队列只有入队没有消耗,请求数量很快就会达到最大。
    9508
    网络已断开,未建立连接,或者建立 socket 连接时,检测到无网络。
    9509
    网络连接已建立,重复创建连接,内部错误。
    9510
    建立网络连接超时,请等网络恢复后重试。
    9511
    网络连接已被拒绝,请求过于频繁,服务端拒绝服务。
    9512
    没有到达网络的可用路由,请等网络恢复后重试。
    9513
    系统中没有足够的缓冲区空间资源可用来完成调用,系统过于繁忙,内部错误。
    9514
    对端重置了连接,可能服务端过载,SDK 内部会自动重连,请等网络连接成功 onConnSucc ( iOS ) 或 onConnected ( Android ) 回调后重试。
    9515
    socket 套接字无效,内部错误。
    9516
    IP 地址解析失败,内部错误,可能是本地 imsdk_config 配置文件被损坏,读取到 IP 地址非法。
    9517
    网络连接到中间节点或服务端重置,引起连接失效,内部错误,SDK 内部会自动重连,请等网络连接成功 onConnSucc ( iOS ) 或 onConnected ( Android ) 回调后重试。
    9518
    请求包等待进入待发送队列超时,发送时网络连接建立比较慢 或 频繁断网重连时,会出现该错误,请检查网络连接是否正常。
    9519
    请求包已进入 IM SDK 待发送队列,等待进入操作系统的网络层时超时。一般可能原因是本地网络受限/不通或本地网络与 IM SDK 后台连接不通。建议用不同的网络环境分别运行 IM SDK 来确认是否因当前网络环境问题引起。
    9520
    请求包已由 IM SDK 待发送队列进入操作系统网络层,等待服务端回包超时。一般可能原因是本地网络受限/不通或本地网络与 IM SDK 后台连接不通。建议用不同的网络环境分别运行 IM SDK 来确认是否因当前网络环境问题引起。
    9521
    请求包已进入待发送队列,部分数据已发送,等待发送剩余部分出现超时,可能上行带宽不足,请检查网络是否畅通,在回调错误时检测有联网。
    9522
    请求包长度大于限制,最大支持 1MB 。
    9523
    请求包已进入待发送队列,等待进入系统的网络 buffer 超时,数据包较多 或 发送线程处理不过来,在回调错误码时检测到没有联网。
    9524
    请求包已进入系统的网络 buffer ,等待服务端回包超时,可能请求包没离开终端设备、中间路由丢弃、服务端意外丢包或回包被系统网络层丢弃,在回调错误码时检测到没有联网。
    9525
    请求包已进入待发送队列,部分数据已发送,等待发送剩余部分出现超时,可能上行带宽不足,请检查网络是否畅通,在回调错误码时检测到没有联网。

    (二)服务端的错误码

    接入层的错误码

    错误码
    描述
    -302
    Server 的连接数量超出限制,服务端拒绝服务。
    -10001
    Key 过期。Key 是根据 UserSig 生成的内部票据,Key 的有效期小于或等于 UserSig 的有效期。请重新调用 TIMManager.getInstance().login 登录接口生成新的 Key。
    -10003
    Ticket 过期。Ticket 是根据 UserSig 生成的内部票据,Ticket 的有效期小于或等于 UserSig 的有效期。请重新调用 TIMManager.getInstance().login 登录接口生成新的 Ticket。
    -10004
    票据验证没通过。请重新调用 TIMManager.getInstance().login 登录接口生成新的票据。
    -10005
    不允许空 Key。
    -10006
    Key 中的账号和请求包头的账号不匹配。
    -10007
    验证码下发超时。
    -10008
    需要带上 Key 和 Ticket。
    -10009
    Cookie 检查不匹配。
    -10106
    解密失败次数超过阈值,通知终端需要重置,请重新调用 TIMManager.getInstance().login 登录接口生成新的 Key。
    -10108
    预付费欠费。
    -10109
    请求包格式错误。
    -10110
    SDKAppID 黑名单。
    -10111
    SDKAppID 设置 service cmd 黑名单。
    -10112
    SDKAppID 停用。
    -10113
    频率限制(用户),频率限制是设置针对某一个协议的每秒请求数的限制。
    -10114
    过载丢包(系统),连接的服务端处理过多请求,处理不过来,拒绝服务。
    -20009
    终端访问接口超频。

    资源文件错误码

    错误码
    描述
    114000
    要发送的资源文件不存在。
    114001
    要发送的资源文件不允许访问。
    114002
    文件大小超过限制。
    114003
    用户取消发送,如发送过程中登出等原因。
    114004
    读取文件内容失败。
    114005
    资源文件(如图片、文件、语音、视频)传输超时,一般是网络问题导致。
    114011
    参数非法。
    115066
    文件 MD5 校验失败。
    115068
    分片 MD5 校验失败。

    后台公共错误码

    错误码
    描述
    60002
    HTTP 解析错误 ,请检查 HTTP 请求 URL 格式。
    60003
    HTTP 请求 JSON 解析错误,请检查 JSON 格式。
    60004
    检查账号失败,请稍后重试。
    60005
    检查账号失败,请稍后重试。
    60006
    SDKAppID 失效,请核对 SDKAppID 有效性。
    60007
    REST 接口调用频率超过限制,请降低请求频率。
    60008
    服务请求超时或 HTTP 请求格式错误,请检查并重试。
    60009
    请求资源错误,请检查请求 URL。
    60010
    REST API 请求的 UserID 字段请填写 App 管理员账号。
    60011
    SDKAppID 请求频率超限,请降低请求频率。
    60012
    REST 接口需要带 SDKAppID,请检查请求 URL 中的 SDKAppID。
    60013
    HTTP 响应包 JSON 解析错误。
    60014
    检查账号超时,请稍后重试。
    60015
    请求包体 UserID 类型错误,请确认 UserID 为字符串格式。
    60016
    SDKAppID 被禁用。
    60017
    请求被禁用。
    60018
    请求过于频繁,请稍后重试。
    60019
    请求过于频繁,请稍后重试。
    60020
    服务不可用。如未购买基础服务套餐包或套餐包过期失效,请购买基础服务套餐包;如腾讯云账号欠费,请充值结清欠款。
    60021
    服务端 REST API 调用来源 IP 非法。
    60025
    服务端 REST API 调用 SDKAppID、Identifier、UserSig 或 ContentType 错误,请检查 URL 参数。
    60026
    服务端 REST API 调用域名或 SDKAppID 与应用站不匹配。
    60027
    不允许访问非 TPush 产品资源。
    60028
    服务端 REST API 24小时内请求量超过体验版限制。
    80001
    消息或者资料中文本存在敏感内容,禁止下发。
    80002
    发消息包体过长,目前支持最大12K消息包体长度,请减少包体大小重试。
    80003
    发单聊消息前回调或发群聊消息前回调失败或回包超时,消息不下发。可在控制台自助配置 事件发生之前回调超时的处理策略
    80004
    消息中图片存在敏感内容,禁止下发。
    80005
    服务已停用,如版本到期请购买或续费套餐包,如账号欠费请充值。

    账号错误码

    错误码
    描述
    70001
    UserSig 已过期,请重新生成。建议 UserSig 有效期设置不小于24小时。
    70002
    UserSig 长度为0,请检查传入的 UserSig 是否正确。
    70003
    UserSig 非法,请使用官网提供的 API 重新 生成 UserSig
    70005
    UserSig 非法,请使用官网提供的 API 重新 生成 UserSig
    70009
    UserSig 验证失败,可能因为生成 UserSig 时混用了其他 SDKAppID 的私钥或密钥导致,请使用对应 SDKAppID 下的私钥或密钥重新 生成 UserSig
    70013
    请求中的 UserID 与生成 UserSig 时使用的 UserID 不匹配,您可以在即时通信 IM 控制台的【 开发辅助工具】页面校验 UserSig。
    70014
    请求中的 SDKAppID 与生成 UserSig 时使用的 SDKAppID 不匹配,您可以在即时通信 IM 控制台的【 开发辅助工具】页面校验 UserSig。
    70016
    公钥不存在,UserSig 验证失败,请在即时通信 IM 控制台 获取密钥
    70020
    SDKAppID 未找到,请在即时通信 IM 控制台确认应用信息。
    70050
    UserSig 验证次数过于频繁。请检查 UserSig 是否正确,并于1分钟后重新验证。您可以在即时通信 IM 控制台的【 开发辅助工具】页面校验 UserSig。
    70051
    账号被拉入黑名单。
    70107
    请求的用户账号不存在。
    70114
    因安全原因被限制登录,请不要频繁登录。
    70169
    服务端内部超时,请稍后重试。
    70202
    服务端内部超时,请稍后重试。
    70206
    请求中批量数量不合法。
    70402
    参数非法,请检查必填字段是否填充,或者字段的填充是否满足协议要求。
    70404
    您使用的SDK版本太低,请升级到最新版本。
    70403
    请求失败,需要 App 管理员权限。
    70398
    账号数超限。如需创建多于100个账号,请将应用升级,具体操作指引请参见 购买指引
    70500
    服务端内部错误,请稍后重试。
    71000
    删除账号失败。仅支持删除体验版账号,您当前应用暂不支持账号删除。
    72000
    您当前应用为体验版,日活跃用户数(DAU)超过免费额度。若需解除该限制,请将应用升级为专业版或旗舰版,具体操作指引请参见 购买指引
    72001
    请在控制台开启用户状态查询及状态变更通知配置,具体操作指引请参见 操作指引
    72002
    您当前应用为开发版,月活跃用户数(MAU)超过免费额度。若需解除该限制,请将应用升级为标准版或进阶版,具体操作指引请参见购买指引
    72010
    单用户的登录、登出、切前台、切后台和设置离线推送配置信息请求超过频率限制。
    72011
    请在 控制台 > 登录与消息 开启全局消息免打扰相关的配置。
    72012
    请在控制台开启用户资料变更订阅配置,具体操作指引请参见 操作指引

    资料错误码

    错误码
    描述
    40001
    请求参数错误,请根据错误描述检查请求是否正确。
    40002
    请求参数错误,没有指定需要拉取资料的用户账号。
    40003
    请求的用户账号不存在。
    40004
    请求需要 App 管理员权限。
    40006
    服务端内部错误,请稍后重试。
    40007
    没有资料字段的读权限。
    40008
    没有资料字段的写权限。
    40009
    资料字段的 Tag 不存在。
    40601
    资料字段的 Value 长度超过500字节。
    40605
    标配资料字段的 Value 错误,详情可参见 标配资料字段
    40610
    资料字段的 Value 类型不匹配,详情可参见 标配资料字段

    关系链错误码

    错误码
    描述
    30001
    请求参数错误,请根据错误描述检查请求是否正确。
    30002
    SDKAppID 不匹配。
    30003
    请求的用户账号不存在。
    30004
    请求需要 App 管理员权限。
    30006
    服务端内部错误,请重试。
    30007
    网络超时,请稍后重试。
    30008
    并发写导致写冲突,建议使用批量方式。
    30009
    后台禁止该用户发起加好友请求。
    30010
    自己的好友数已达系统上限。
    30011
    分组已达系统上限。
    30012
    未决数已达系统上限。
    30013
    黑名单数已达系统上限。
    30014
    对方的好友数已达系统上限。
    30515
    请求添加好友时,对方在自己的黑名单中,不允许加好友。
    30516
    请求添加好友时,对方的加好友验证方式是不允许任何人添加自己为好友。
    30525
    请求添加好友时,自己在对方的黑名单中,不允许加好友。
    30539
    A 请求加 B 为好友,B 的加好友验证方式被设置为“AllowType_Type_NeedConfirm”,这时 A 与 B 之间只能形成未决关系,该返回码用于标识加未决成功,以便与加好友成功的返回码区分开,调用方可以捕捉该错误给用户一个合理的提示。
    30540
    添加好友请求被安全策略打击,请勿频繁发起添加好友请求。
    30614
    请求的未决不存在。
    31704
    与请求删除的账号之间不存在好友关系。
    31707
    删除好友请求被安全策略打击,请勿频繁发起删除好友请求。
    31804
    请求的用户账号不存在。

    最近联系人错误码

    错误码
    描述
    50001
    请求的用户账号不存在。
    50002
    请求参数错误,请根据错误描述检查请求是否正确。
    50003
    请求需要 App 管理员权限。
    50004
    服务端内部错误,请重试。
    50005
    网络超时,请稍后重试。
    51006
    修改会话标记时,调整的会话数为空或者超过了100个上限。
    51007
    GroupID 换 GroupCode 失败,内部错误或 Group 已经解散。
    51008
    会话分组的总的会话数超过了1000。
    51009
    删除会话分组时分组不存在。
    51010
    会话分组数超过了20个上限。
    51011
    会话分组名超过了32个字节。
    51012
    超过置顶会话数量上限。置顶会话数上限为50,不支持增加。

    消息错误码

    错误码
    描述
    20001
    请求包非法。
    20002
    UserSig 或 A2 失效。
    20003
    消息发送方或接收方 UserID 无效或不存在,请检查 UserID 是否已导入即时通信 IM。
    20004
    网络异常,请重试。
    20005
    服务端内部错误,请重试。
    20006
    触发发送单聊消息之前回调,App 后台返回禁止下发该消息。
    20007
    发送单聊消息,被对方拉黑,禁止发送。
    消息发送状态默认展示为失败,您可以登录控制台修改该场景下的消息发送状态展示结果,具体操作请参见 黑名单检查
    20008
    消息发送方和接收方属于不同的 SDKAppID。原因是客户端切换了 SDKAppID,但数据库未进行清理。解决办法是在切换 SDKAppID 时删除原来的数据库。
    20009
    消息发送双方互相不是好友,禁止发送(配置单聊消息校验好友关系才会出现)。
    20010
    发送单聊消息,自己不是对方的好友(单向关系),禁止发送。
    20011
    发送单聊消息,对方不是自己的好友(单向关系),禁止发送。
    20012
    发送方被禁言,该条消息被禁止发送。
    20016
    消息撤回超过了时间限制(默认2分钟)。
    20018
    删除漫游内部错误。
    20022
    该待撤回的消息不存在,请检查。
    20023
    该消息已被撤回。
    20028
    并发修改消息导致冲突,请重试。
    21005
    设置 token 请求比登录请求先到后台,请确保先登录,后设置 token。
    22001
    没有上传过任何离线推送证书。
    22002
    网络异常,请重试。
    22003
    上传的 token 为空。
    22004
    上传的 token 长度超过256字节。
    22005
    登录请求数据超过1024字节。
    22006
    请求超频。
    90001
    JSON 格式解析失败,请检查请求包是否符合 JSON 规范。
    90002
    JSON 格式请求包中 MsgBody 不符合消息格式描述,或者 MsgBody 不是 Array 类型,请参考 TIMMsgElement 对象 的定义。
    90003
    JSON 格式请求包体中缺少 To_Account 字段或者 To_Account 账号不存在。
    90005
    JSON 格式请求包体中缺少 MsgRandom 字段或者 MsgRandom 字段不是 Integer 类型。
    90006
    JSON 格式请求包体中缺少 MsgTimeStamp 字段或者 MsgTimeStamp 字段不是 Integer 类型。
    90007
    JSON 格式请求包体中 MsgBody 类型不是 Array 类型,请将其修改为 Array 类型。
    90008
    JSON 格式请求包体中缺少 From_Account 字段或者 From_Account 账号不存在。
    90009
    请求需要 App 管理员权限。
    90010
    JSON 格式请求包不符合消息格式描述,请参考 TIMMsgElement 对象 的定义。
    90011
    批量发消息目标账号超过500,请减少 To_Account 中目标账号数量。
    90012
    To_Account 没有注册或不存在,请确认 To_Account 是否导入即时通信 IM 或者是否拼写错误。
    90018
    请求的账号数量超过限制。
    90022
    推送条件中的 TagsOr 和 TagsAnd 有重复标签。
    90024
    推送过于频繁,每两次推送间隔必须大于1秒。
    90026
    消息离线存储时间错误(最多不能超过7天)。
    90030
    属性长度为0或大于50。
    90031
    JSON 格式请求包体中 SyncOtherMachine 字段不是 Integer 类型。
    90032
    推送条件中的 tag 数量大于10,或添加标签请求中的标签数量大于10。
    90033
    属性无效。
    90034
    标签长度大于50。
    90040
    推送条件中其中1个 tag 为空。
    90043
    JSON 格式请求包中 OfflinePushInfo 不符合消息格式描述,请参考 OfflinePushInfo 对象 的定义。
    90044
    JSON 格式请求包体中 MsgLifeTime 字段不是 Integer 类型。
    90045
    未开通全员推送功能。
    90047
    推送次数超过当天限额(默认为100次)。
    90048
    请求的用户账号不存在。
    90054
    撤回请求中的 MsgKey 不合法。
    90055
    批量发消息的包体过长,目前支持最大12K消息包体长度。
    90994
    服务内部错误,请重试。
    90995
    服务内部错误,请重试。
    91000
    服务内部错误,请重试。
    90992
    服务内部错误,请重试;如果所有请求都返回该错误码,且 App 配置了第三方回调,请检查 App 服务端是否正常向即时通信 IM 后台服务端返回回调结果。
    93000
    JSON 数据包超长,消息包体请不要超过12K。
    91101
    Web 端长轮询被踢(Web 端同时在线实例个数超出限制)。
    90057
    批量发单聊消息超出最大频率限制。
    120001 - 130000
    单聊第三方回调返回的自定义错误码。

    群组错误码

    错误码
    描述
    10002
    服务端内部错误,请重试。
    10003
    请求中的接口名称错误,请核对接口名称并重试。
    10004
    参数非法,请根据错误描述检查请求是否正确。
    10005
    请求包体中携带的账号数量过多。
    10006
    操作频率限制,请尝试降低调用的频率。
    10007
    操作权限不足(例如 Public 群组中普通成员尝试执行踢人操作,但只有 App 管理员才有权限;或者非群成员操作)。
    10009
    该群不允许群主主动退出。
    10010
    群组不存在,或者曾经存在过,但是目前已经被解散。
    10011
    解析 JSON 包体失败,请检查包体的格式是否符合 JSON 格式。
    10012
    发起操作的 UserID 非法,请检查发起操作的用户 UserID 是否填写正确。
    10013
    用户已经是群成员。
    10014
    群已满员,无法将请求中的用户加入群组,如果是批量加人,可以尝试减少加入用户的数量。
    10015
    无效的群组 ID,表示群组不存在或已经被解散。
    10016
    App 后台通过第三方回调拒绝本次操作。
    10017
    因被禁言而不能发送消息,请检查发送者是否被设置禁言。
    10018
    应答包长度超过最大包长(1MB),请求的内容过多,请尝试减少单次请求的数据量。
    10019
    请求的用户账号不存在。
    10021
    群组 ID 已被使用,请选择其他的群组 ID。
    10023
    发消息的频率超限,请延长两次发消息时间的间隔。
    10024
    此邀请或者申请请求已经被处理。
    10025
    群组 ID 已被使用,并且操作者为群主,可以直接使用。
    10026
    该 SDKAppID 请求的命令字已被禁用。
    10030
    请求撤回的消息不存在。
    10031
    消息撤回超过了时间限制(默认2分钟)。
    10032
    请求撤回的消息不支持撤回操作。
    10033
    群组类型不支持消息撤回操作。
    10034
    该消息类型不支持删除操作。
    10035
    音视频聊天室和在线成员广播大群不支持删除消息。
    10036
    音视频聊天室创建数量超过了限制,请参考 价格说明 购买预付费套餐“IM音视频聊天室”。
    10037
    单个用户可创建和加入的群组数量超过了限制,请参考 价格说明 购买或升级预付费套餐“单人可创建与加入群组数”。
    10038
    群成员数量超过限制,请参考 价格说明 购买或升级预付费套餐“扩展群人数上限”。(升级后需要调用 修改群资料接口 修改群最大人数)
    10041
    该应用(SDKAppID)已配置不支持群消息撤回。
    10044
    表示该群类型不支持获取漫游,例如:AVChatRoom
    10045
    自定义属性 key 超过大小限制32字节。
    10046
    自定义属性单个 val 超过了大小限制4000字节。
    10047
    自定义属性 key 数量超过了限制16。
    10048
    自定义属性所有 key 对应的 val 大小之和超过上限16000字节。
    10049
    自定义属性写操作触发频控。
    10050
    删除不存在的自定义属性。
    10051
    消息删除超过最大范围限制。
    10052
    消息删除时候群里不存在消息。
    10053
    群@数量超过上限30。
    10054
    群成员过多,请分页拉取。
    10056
    自定义属性写操作竞争冲突,请获取最新的自定义属性后再进行写操作。
    10058
    表示体验版超过100个群的限制,需要购买套餐包提升建群数量限制。
    10059
    该特性需要购买进阶版才可以支持。
    10060
    群人数超过已读回执群上限。
    10061
    在线消息不支持已读回执。
    10062
    已读回执信息不存在。
    10062
    已读回执信息不存在。
    10063
    群计数器 Key 数量超过限制,最大为20个。
    10070
    置顶消息超出数量限制。
    11000
    未开通社群功能。

    离线推送错误码

    错误码
    描述
    -195
    谷歌推送构建推送对象失败,通常是证书错误导致。
    -196
    参数缺失,选择了 intent,但是没有设置 intent 的值。
    -197
    证书错误,请检查证书相关参数排查。
    -198
    厂商响应错误。
    -199
    厂商网络异常。
    -200
    IM 后台网络错误。
    -201
    合法性检查没有通过,例如 token 或者证书 ID 错误。
    -202
    在推送给厂商之前,构建对象失败。
    -203
    华为日推送限制。

    获取运营数据错误码

    错误码
    描述
    1001
    请求非法;请检查“请求 URL”是否正确。
    1002
    参数非法;请检查是否管理员账号,必填字段是否填充,或者字段的填充是否满足协议要求。
    1003
    系统错误。
    1004
    文件尚未生成,或者请求时段内没有消息。
    1005
    文件已过期。

    (三)IM SDK V3 版本的错误码

    错误码
    描述
    6003
    批量操作无成功结果。
    6011
    无效接收方。
    6012
    请求超时。
    6018
    INIT CORE 模块失败。
    6020
    SessionNode 为 null 。
    6023
    在登录完成前进行了登出(在登录时返回)。
    6024
    TLS SDK 未初始化。
    6025
    TLS SDK 没有找到相应的用户信息。
    6100
    QALSDK 未知原因BIND失败。
    6101
    缺少 SSO 票据。
    6102
    重复 BIND。
    6103
    TinyId 为空。
    6104
    GUID 为空。
    6105
    解注册包失败。
    6106
    注册超时。
    6107
    正在 BIND 操作中。
    6120
    发包未知错误。
    6121
    发送请求包时没有网络。
    6122
    发送回复包时没有网络。
    6123
    发送请求包时没有权限。
    6124
    SSO 错误。
    6125
    请求超时。
    6126
    回复超时。
    6127
    重发失败。
    6128
    重发时没有真正发送。
    6129
    保存被过滤。
    6130
    发送过载。
    6131
    数据逻辑错误。
    6150
    proxy_manager 没有完成服务端数据同步。
    6151
    proxy_manager 正在进行服务端数据同步。
    6152
    proxy_manager 同步失败。
    6153
    proxy_manager 请求参数,在本地检查不合法。
    6160
    Group assistant 请求字段中包含非预设字段。
    6161
    Group assistant 群资料本地存储没有开启。
    6162
    加载群资料失败。
    6200
    请求的时候没有网络。
    6201
    响应的时候没有网络。
    6205
    QALSDK 服务未就绪。
    6207
    账号认证失败( TinyId 转换失败),请检查 UserID 是否存在并有效。
    6209
    在应用启动后没有尝试联网。
    6210
    QALSDK 执行失败。
    6211
    请求非法,toMsgService 非法。
    6212
    请求队列满。
    6213
    已经被其他终端踢了。
    6214
    服务被暂停。
    6215
    SSO 签名错误。
    6216
    SSO cookie 无效。
    6217
    登录时 TLS SDK 回包校验,包体长度错误。
    6218
    登录时 OPENSTATSVC 向 OPENMSG 上报状态超时。
    6219
    登录时 OPENSTATSVC 向 OPENMSG 上报状态时解析回包失败。
    6220
    登录时 TLS SDK 解密失败。
    6221
    WIFI 需要认证。
    6222
    用户已取消。
    6223
    消息撤回超过了时间限制(默认2分钟)。
    6224
    缺少 UGC 扩展包。
    6226
    自动登录,本地票据过期,需要 UserSig 手动登录。
    6300
    没有可用的短连接 SSO 。
    70101
    登录返回,票据过期。
    90101
    IM SDK 已经初始化无需重复初始化。
    115000
    OpenBDH 错误码。
    6250
    请求时没有网络,请等网络恢复后重试。
    6251
    响应时没有网络,请等网络恢复后重试。
    6252
    QALSDK 执行失败。
    6253
    请求非法,toMsgService 非法。
    6254
    请求队列満。
    6255
    已经被其他终端踢了。
    6256
    服务被暂停。
    6257
    SSO 签名错误。
    6258
    SSO cookie 无效。
    注意
    如问题仍无法解决,您可以 提交工单 提供使用接口、错误码以及错误信息给技术支持人员解决。
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持