文档

消息推送状态码

下面分别对公共的以及各推送通道对应的消息推送状态码进行说明。

公共消息推送状态码

状态码

描述

解释

-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 连接断开。出现该状态的原因如下:

  • 在控制台上配置的苹果推送证书环境与推送的设备 token 不匹配。

  • 在 App 安装包中打包的证书和在控制台上配置的证书不匹配。

  • 工程中的 BundleId 和在控制台上配置的 BundleId 不一致。

关于在控制台上配置 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

权限校验失败。

  • 本页导读 (0)
文档反馈