状态码表

Posted 2020-11-02

提供使用融云 SDK 及 Server API 接口时，可能遇上的状态码、原因及需要进行的处理方式。

Server API 状态码

HTTP 状态码

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

业务返回码

code	描述	详细解释	HTTP 状态码
404	未找到	服务器找不到请求的地址	404
1000	服务内部错误	服务器端内部逻辑错误,请稍后重试	500
1001	App Secret 错误	App Key 与 App Secret 不匹配	401
1002	参数错误	参数错误，详细的描述信息会说明	400
1003	无 POST 数据	没有 POST 任何数据	400
1004	验证签名错误	验证签名错误	401
1005	参数长度超限	参数长度超限，详细的描述信息会说明	400
1006	App 被锁定或删除	App 被锁定或删除	401
1007	被限制调用	该方法被限制调用，详细的描述信息会说明	401
1008	调用频率超限	调用频率超限，详细的描述信息会说明，广播消息未开通时也会返回此状态码。	429
1009	服务未开通	未开通该服务，请到开发者管理后台开通或提交工单申请。	430
1015	删除的数据不存在	要删除的保活聊天室 ID 不存在。	200
1016	设置保活聊天室个数超限	设置的保活聊天室个数超限。	403
1050	内部服务超时	内部服务响应超时	504
2007	测试用户数量超限	测试用户数量超限	403

android、ios 状态码

下面列举了 SDK 使用过程中，可能遇上的错误码、原因以及需要进行的处理。

code	原因
-3	参数错误（Android 平台）。
-2	IPC 进程意外终止（Android 平台）。
405	已被对方加入黑名单。
20604	发送消息频率过高， 1 秒钟最多只允许发送 5 条消息。
21406	不在该讨论组中。
22406	不在该群组中。
22408	在群组中已被禁言。
23406	不在该聊天室中。
23408	在该聊天室中已被禁言。
23409	已被踢出并禁止加入聊天室。
23410	聊天室不存在。
23412	聊天室接口参数无效。
23414	聊天室云存储业务未开通。
24012	通话鉴权失败。
24014	实时音视频功能未开启。
24016	实时音视频功能已关闭。
25101	消息撤回时，参数错误。
29106	未关注此公众号。
29201	无效的公众号。(由会话类型和 Id 所标识的公众号会话是无效的)。
30001	当前连接不可用（连接已经被释放）。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。
30002	当前连接不可用。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。
30003	消息响应超时。
30004	导航 HTTP 发送失败。如果是偶尔出现此错误，SDK 会做好自动重连，开发者无须处理。对于 iOS 平台，如果一直连接不上，应该是您没有设置好 ATS。ATS 默认只使用 HTTPS 协议，当 HTTP 协议被禁止时 SDK 会一直 30004 错误。您可以在我们 iOS 开发文档中搜索到 ATS 设置。
30007	导航 HTTP 请求失败。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。
30008	导航 HTTP 返回数据格式错误。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。
30010	Socket 不存在，一般由于没有 connect() 引起的。
30011	Socket 连接被断开，主要有两种情况，一是用户主动调用 disconnect 之后，Socket 被服务器断开；二是中间路由原因等导致 Socket 断开。
30012	PING 失败。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。
30013	PING 超时。 建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。
30014	信令发送失败。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。
30015	连接过于频繁。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。
30016	消息大小超限，消息体（序列化成 JSON 格式之后的内容）最大 128k bytes。
30017	请求内存分配失败，可能是手机内存不够等原因引起的。
31000	连接 ACK 超时。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。
31002	App Key 错误。请检查您使用的 App Key 是否正确。
31003	服务器当前不可用（预留）。 建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。
31004	Token 无效。Token 无效一般有以下两种原因。一是 Token 错误，请您检查客户端初始化使用的 App Key 和您服务器获取 Token 使用的 App Key 是否一致；二是 Token 过期，是因为您在开发者后台设置了 Token 过期时间，您需要请求您的服务器重新获取 Token 并再次用新的 Token 建立连接。
31006	连接重定向。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。
31007	BundleID 不正确。请检查您 App 的 BundleID 是否正确。
31008	App Key 被封禁或已删除。请检查您使用的 App Key 是否正确。
31009	用户被封禁。请检查您使用的 Token 是否正确，以及对应的 UserId 是否被封禁。
31010	当前用户在其他设备上登录，此设备被踢下线
32061	连接被拒绝。建立连接的临时错误码，SDK 会做好自动重连，开发者无须处理。
33001	SDK 没有初始化，在使用 SDK 任何功能之前，必须先调用 Init。
33002	数据库错误，请检查您使用的 Token 和 userId 是否正确。
33003	开发者接口调用时传入的参数错误，请检查接口调用时传入的参数类型和值。
33007	历史消息云存储业务未开通。
-1000	开发者接口调用时传入的参数错误。请检查接口调用时传入的参数类型和值。