IM 即时通讯
Android
新手接入指南
产品介绍
简介
主要功能
产品优势
海外数据中心
接口及业务限制
功能介绍
帐号集成与登录
群组功能
聊天室功能
聊天室标签功能
圈组功能
多端登录与互踢策略
质量数据监控台
更新日志
IM UIKit 更新日志
NIM SDK 开发版更新日志
NIM SDK 稳定版更新日志
体验 Demo
下载 SDK 与 Demo 源码
快速开始
跑通 IM Demo 源码
实现单聊消息收发(不含 UI)
实现圈组消息收发(不含 UI)
含 UI 集成
什么是 IM UIKit
IM UIKit 功能列表
快速集成 IM UIKit
组件导入
初始化
界面跳转
自定义用户信息
全局配置
IM UIKit API 概览
会话列表相关
集成会话列表界面
会话列表事件监听
自定义会话列表界面 UI
会话列表 API 概览
会话消息相关
集成会话界面
会话界面事件监听
实现自定义消息发送(含 UI)
自定义会话界面 UI
会话消息 API 概览
通讯录相关
集成通讯录界面
自定义通讯录界面 UI
通讯录界面事件监听
通讯录 API 概览
不含 UI 集成
使用说明
集成与初始化
登录管理
消息相关
消息概述
消息收发
自定义消息收发
消息配置选项
多媒体资源存储场景
广播消息收发
消息已读回执
消息撤回
消息重发与转发
消息更新
消息过滤
语音消息处理
插入本地消息
历史消息
最近会话
服务端会话服务
用户资料
用户关系
在线状态订阅
系统通知
离线推送与消息提醒
群组功能
群组概述
群组管理
群成员管理
群消息管理
超大群功能
聊天室
圈组功能
登录管理
服务器相关
服务器概述
服务器管理
服务器成员管理
服务器未读数管理
频道相关
频道概述
频道管理
频道黑白名单
频道未读数管理
实时互动频道
频道分组
频道分组黑白名单
搜索服务器和频道
身份组相关
身份组概述
身份组应用场景
服务器身份组
频道身份组
用户定制权限
频道分组身份组
自定义权限
成员权限查询与判定
身份组相关查询
圈组订阅机制
消息相关
图解圈组消息流转
圈组消息收发
圈组消息撤回
圈组消息更新
圈组消息删除
会话消息回复(Thread)
圈组快捷评论
消息正在输入
获取频道最后一条消息
查询历史消息
圈组消息缓存
圈组消息搜索
系统通知
圈组离线推送
圈组内容审核
圈组相关抄送
圈组第三方回调
反垃圾
聊天扩展
其他
最佳实践
IM 应用隐私合规
聊天室重要消息投递
API 参考
Android API 参考
Android 端状态码
IM 控制台指南
创建应用
注册 IM 账号
升级服务
开通聊天室功能
常见问题
FAQ
错题集
Android 端推送问题排查
服务协议

Android 端状态码

更新时间: 2022/09/08 15:04:42

Android端状态码

code 详细描述
408 超时
1000 本地操作异常

状态码详解

用户名或密码错误302

当客户端SDK执行登录后,回调状态码302时,请检查当前的AppKey、accid(accout)与token三者是否一一对应。较常见的原因如:token不正确或不是最新、该AppKey下无此accid等。
详情参见关于IM登录失败-返回302

非法操作或没有权限403

当执行非法操作时,会返回状态码403。常见的非法操作如下:

  • 如果网易云信控制台配置非好友不允许发消息,客户端SDK向非好友发消息会返回403。
  • 聊天室业务中,要将管理员变成普通用户,直接取消其管理员权限即可。不能直接将管理员设置为 普通成员,否则可能会返回403。
    聊天室业务中,只有创建者可以对管理员进行操作,管理员不能对创建者和其他管理员进行操作,否则可能会返回403。
  • 第三方回调业务中,如果第三方回调功能不放行某条消息,则发送方SDK会回调返回403。
    被好友拉黑后,给对方发消息,也会先进行第三方回调。如果不放行,SDK会返回403;如果放行,SDK会返回7101。
  • 如果账号已经退群或者被踢出群,尝试群消息撤回时,会返回403。但是在撤回时长范围内,管理员仍然可以通过客户端撤回其他已被踢出的普通成员发送过的消息。
  • 当前AppKey对应的云信应用已关停时,调用IM服务端API会返回{"desc": "app is forbidden", "code": 403}。
  • 当调用IM服务端API,且传入的昵称、签名等信息命中了反垃圾(例如:涉政、违禁、广告等),会返回{"desc": "forbbiden info", "code": 403}。
  • 互动白板业务中的文档转码上传功能里,文档相关信息只能由上传者自己查询,其他账号查询会返回403。
  • IM服务端API群组相关接口适用于高级群与超大群。其他会返回{"desc": "no support", "code":403}。
  • 若双方无好友关系,则调用更新好友相关信息的接口将会返回403。

在未开通/启用某项功能前,调用相应的接口也会返回状态码403。常见的情况如下:

  • 未开通事件订阅(常用于在线事件订阅)的情况下,使用相关功能,会返回403。
  • 当前应用无收发IM消息的权限(在控制台会有相应提示),当调用发消息的接口时,会返回403。具体请咨询销售顾问。
  • 删除漫游消息时,如果应用下没有开启消息漫游功能,调用相关接口会返回403。

对象不存在404

当调用接口回调出404状态码后,请检查传参是否正确,常见的情况如:

  • 必传参数为空时,可能会回调404。
  • 传入的参数实际不存在。如传入实际上未注册过的accid,不存在的群id等。

客户端请求超时408

当调用接口回调出408状态码后,请检查当前所处的网络是否正常。常见的情况如:

  • 网络连接断开后,调用联网请求接口,此时会回调408。
  • 在未成功登录的情况下,调用联网请求接口。
  • Android SDK 4.3.0及之前的版本,没有对于Android 8.0以上系统版本的适配,登录时可能出现408,请更新到最新版本SDK。

参数错误414

当调用接口回调出414状态码后,请检查传参是否正确。常见的情况如:

  • 传参的数据类型与接口要求不一致。
  • 如果在控制台 > 应用 > App Key管理 > 标识管理,选中了进行标识安全验证:当请求登录的客户端App标识不在以上列表中时,登录请求将被拒绝,当客户端App标识(iOS Bundle Identifier / Android Package Name)不在配置的列表中,登录接口会返回414。
  • 当调用服务端接口,并传入未注册过的accid时,也会回调414。
  • 聊天室业务中,如果聊天室被关闭,查询聊天室消息历史会返回414。例如:调用IM服务端API「聊天室云端历史消息查询」会返回{"desc": "check roomid", "code": 414}。
  • 如果消息被反垃圾命中,尝试撤回时,会返回错误码414。
  • 不能添加自己为好友,否则返回414。
  • 调用短信相关接口时,若开发者传入的参数不符合JSON格式会返回{"code": 414, "msg": "'mobiles' / 'params' should be json format"},请更正。
  • Web SDK中,群已读回执功能里,参数teamMsgReceipts为数组格式,数组元素上限数50,超过会返回414。
  • 调用IM服务端API时返回{"desc":"bad http headers", "code":414},可能是校验信息错误。关于校验信息,请点此查看
    [注意] 计算CheckSum时使用的是AppSecret而不是AppKey。
  • 返回{"desc": "CurTime is illegal", "code": 414}/{"desc": "CurTime is expired", "code": 414},表示传入的CurTime参数与当前UTC时间戳不一致(超前或滞后)。可能原因是:
    • 开发者没有实时动态获取当前UTC时间戳。
    • 应用服务器配置的时区和时间与实际不一致。
  • 返回{"desc":"body not json", "code":414}。IM服务端接口请求Content-Type为application/x-www-form-urlencoded,请对参数值进行urlencode,避免特殊字符造成解析失败。
  • 返回{"desc":"retry again", "code":414}。调用创建网易云信IM账号并发创建账号时,不同的请求传入相同的accid参数可能返回此错误。
  • 如果群主账号被封禁后,再调用服务端API解散群,会返回{"desc": "check accid001", "code": 414}。
  • 聊天室相关API返回{"desc":"parameter roomid should be long","code":414},可能原因包括但不限于:
    • 开发者对roomid参数的值进行了误编码,例如PHP中对其进行json_encode可能导致出现此报错。
  • 对于更新聊天室信息,如果只传入roomid、needNotify和notifyExt,而没有传入其它任何需要更新的参数,则会返回{"desc": "no valid param provided, skip update!", "code": 414}。
  • 调用调用创建网易云信IM账号时,返回{"desc": "Exceed the maximum account XXX", "code":414}。可能原因有:
    • IM免费版账号数上限数为100个。
    • IM专业版试用到期。IM专业版试用期间账号数无上限,试用到期后上限数降为100个。若需继续使用IM专业版,请联系销售顾问开通正式版。

重复操作417

  • 客户端自动登录时,回调417。可能原因参见自动登录返回417
  • 创建多人音视频房间,回调417.可能原因参见关于多人音视频/互动直播房间的注意事项
  • IM服务端API设置聊天室内用户角色返回{desc:"duplicate...", code:"417"},可能原因包括但不限于:
    • 重复操作,例如已经设置某角色之后再次设置,或者已经取消某角色之后再次取消。
    • 设置不当,例如对非管理员角色取消管理员,或者对非聊天室成员进行操作等。

没有权限802

  • 调用IM SDK主动退群接口,返回802。高级群的群主不能直接退群,可以先转让群再退群,或者直接解散群。
  • 调用将群组整体禁言接口设置或解除群组禁言时,如果muteType传入3,表示禁言整个群(包括群主)。这种情况下如果SDK/客户端若再尝试调用禁言接口,会返回802。
此文档是否对你有帮助?
有帮助
我要吐槽
  • Android端状态码
  • 状态码详解
  • 用户名或密码错误302
  • 非法操作或没有权限403
  • 对象不存在404
  • 客户端请求超时408
  • 参数错误414
  • 重复操作417
  • 没有权限802