下面分别对公共的以及各推送通道对应的消息推送状态码进行说明。
公共消息推送状态码
状态码 | 描述 | 解释 |
---|---|---|
-1 | WaitingForVerify | 等待校验。 |
0 | DeviceNotOnlineOrNoResponse | 等待设备上线(推送目标设备与移动推送网关长连接断开)或等待发送确认。 |
1 | NoBindInfo | 无绑定关系。基于用户标识维度推送消息时,确认推送目标(userId)已绑定设备标识。 |
2 | Acked | 使用自建通道推送消息时,表示消息已成功推送至客户端;使用厂商通道推送消息时,表示已成功调用厂商推送网关。 |
99999999 | NONE | 未知状态 |
苹果推送通道
状态码 | 描述 | 解释 |
---|---|---|
2001 | PayloadEmpty | 消息体为空。 |
2002 | PayloadTooLarge | 消息体太大。 |
2003 | BadTopic | 证书的 bundleid 错误。 |
2004 | TopicDisallowed | 证书的 bundleid 非法。 |
2005 | BadMessageId | messageId 错误。 |
2006 | BadExpirationDate | 非法的有效期时间。 |
2007 | BadPriority | 非法的权重。 |
2008 | MissingDeviceToken | 缺少设备 token。 |
2009 | BadDeviceToken | 设备 token 无效、格式错误或不存在。当基于用户维度推送消息,且出现本状态时,您需要检查在绑定时所使用的设备 token 是否正确。建议在绑定完成后,在消息推送控制台上创建极简推送类型的消息进行测试。 |
在开发环境(控制台配置为开发环境证书)下,需要使用个人开发证书打包 App 进行测试。否则会出现 BadDeviceToken。 | ||
2010 | DeviceTokenNotForTopic | 设备 token 和证书不匹配。 |
2011 | Unregistered | token 失效。 |
2013 | BadCertificateEnvironment | 非法的证书环境。 |
2014 | BadCertificate | 非法的证书。 |
2023 | MissingTopic | 未指定 Topic。 |
2024 | ConnClosed | APNS 连接断开。出现该状态的原因如下:
关于在控制台上配置 iOS 推送证书、证书环境以及 BundleId 的详细操作,参见 配置 iOS 推送证书。 |
2025 | ConnUnavailable | APNS 连接未完成。 |
华为推送通道
状态码 | 描述 |
---|---|
100 | 无效未知参数。 |
101 | 无效的 API_KEY。 |
102 | 无效的 SESSION_KEY。 |
106 | App 或者 Session 没有调用当前服务的权限。 |
107 | client 和 secret 需要重新获取(如算法升级等)。 |
109 | nsp_ts 偏差过大。 |
110 | 接口内部异常。 |
111 | 服务繁忙。 |
80000003 | 终端不在线。 |
80000004 | 应用已卸载。 |
80000005 | 响应超时。 |
80000006 | 无路由,终端未连接过 Push。 |
80000007 | 终端在其他大区,不在中国大陆使用 Push。 |
80000008 | 路由不正确,可能终端切换 Push 服务器。 |
80100000 | 参数检查,部分参数错误。 |
80100002 | 不合法的 token 列表。 |
80100003 | 不合法的 payload。 |
80100004 | 不合法的超时时间。 |
80300002 | 无权限下发消息给参数中的 token 列表。 |
80300007 | 请求中所有的 token 都是非法 token。 |
81000001 | 内部错误。 |
80300008 | 认证类错误(请求消息体过大)。 |
小米推送通道
状态码 | 描述 |
---|---|
10001 | 系统错误。 |
10002 | 服务暂停。 |
10003 | 远程服务错误。 |
10004 | IP 限制不能请求该资源。 |
10005 | 该资源需要 appkey 拥有授权。 |
10008 | 参数错误。 |
10009 | 系统繁忙。 |
10012 | 非法请求。 |
10013 | 不合法的用户。 |
10014 | 应用的接口访问权限受限。 |
10017 | 参数值非法。 |
10018 | 请求长度超过限制。 |
10022 | IP 请求频次超过上限。 |
10023 | 用户请求频次超过上限。 |
10024 | 用户请求特殊接口频次超过上限。 |
10026 | 应用被加入黑名单,不能调用 API。 |
10027 | 应用的 API 调用太频繁。 |
10029 | 不合法的设备。 |
21301 | 认证失败。 |
22000 | 非法应用。 |
22001 | 应用不存在。 |
22002 | 应用已经撤销。 |
22003 | 更新应用程序失败。 |
22004 | 缺少应用程序信息。 |
22005 | 应用程序名字不合法。 |
22006 | 应用程序 ID 不合法。 |
22007 | 应用程序 Key 不合法。 |
22008 | 应用程序 Secret 不合法。 |
22020 | 应用程序描述信息不合法。 |
22021 | 用户没有授权给应用程序。 |
22022 | 应用程序 package name 不合法。 |
22100 | 应用通知数据格式不合法。 |
22101 | 太多应用通知消息。 |
22102 | 发送应用通知消息失败。 |
22103 | 应用通知 ID 不合法。 |
20301 | 目标不合法。 |
OPPO 推送通道
状态码 | 描述 | 解释 |
---|---|---|
-1 | Service Currently Unavailable | 服务不可用,此时请开发者稍后再试。 |
-2 | Service in Flow Control | 服务器流量控制。 |
11 | Invalid Auth Token | 不合法的 AuthToken。 |
13 | App Call Limited | 应用调用次数超限,包含调用频率超限。 |
14 | Invalid App Key | 无效的 AppKey 参数。 |
15 | Missing App Key | 缺少 AppKey 参数。 |
16 | Invalid Signature | 签名校验不通过,无效签名。 |
17 | Missing Signature | 签名校验不通过,缺少签名。 |
28 | App Disabled | 应用不可用。 |
29 | Missing Auth Token | 缺少 Auth Token 参数。 |
30 | Api Permission Denied | 该应用没有 API 推送的权限。 |
10000 | Invalid RegistrationId | registration_id 格式不正确。 |
vivo 推送通道
状态码 | 描述 |
---|---|
10000 | 权限认证失败。 |
10040 | 资源已达上限,稍后重试。 |
10050 | alias 和 regId 不能都为空。 |
10055 | title 不能为空。 |
10056 | title 长度不能超过 40 个字符。 |
10058 | content 长度不能超过 100 个字符。 |
10066 | 自定义 key 和 Value 键值对个数不能超过 10 个。 |
10067 | 自定义 key 和 value 键值对不合法。 |
10070 | 发送量总量超出限制。 |
10071 | 超出发送时间允许范围。 |
10072 | 推送速度过快,请稍后再试。 |
10101 | 消息内容审核不通过。 |
10102 | vivo 服务器端未知异常。 |
10103 | 推送内容含敏感信息。 |
10110 | 请配置商业化消息发送频率。 |
10302 | regId 不合法,regId 为无效的 regId,regId 可能已经失效。 |
10303 | requestId 已存在。 |
10104 | 请发送正式信息。请检查 content,不要发送测试内容,正式信息发送的 content 里面不能是纯数字、纯英文、纯符号,符号加数字,不能包含“测试”字样、大括号、中括号。 |
更多 vivo 推送相关的错误码,请参见 vivo 推送错误码参考。
FCM 推送通道
状态码 | 描述 | 解释 |
---|---|---|
90000002 | nvalidRegistration | 目标非法。 |
90000003 | NotRegistered | 目标未注册。 |
90000004 | InvalidPackageName | 包名非法。 |
90000007 | MessageTooBig | 消息体过大。 |
90000009 | InvalidTtl | 离线存活日期非法。 |
90000011 | InternalServerError | FCM 服务异常。 |
90000401 | Authentication | 权限校验失败。 |