服务端错误码
说明：
除非发生网络错误（例如 502 错误），否则推送服务 REST API 的 HTTP 返回码均为200。
请通过应答包体中的 ErrorCode、ErrorInfo 确认错误码，并对照下表查看。
公共错误码（60000 到 79999）请参见 错误码 文档。
错误码 | 含义说明 |
90001 | JSON 格式解析失败，请检查请求包是否符合 JSON 规范。 |
90005 | JSON 格式请求包体中缺少 MsgRandom 字段或者 MsgRandom 字段不是 Integer 类型。 |
90009 | 请求需要 App 管理员权限。 |
90018 | 请求的账号数量超过限制。 |
90020 | 标签长度超过限制（不能超过50字节）。 |
90022 | 推送条件中的 TagsOr 和 TagsAnd 有重复标签。 |
90024 | 推送过于频繁，每两次推送间隔必须大于1秒。 |
90026 | 消息离线存储时间错误。 |
90032 | 推送条件中的 tag 数量大于10，或添加标签请求中的标签数量大于10。 |
90033 | 属性无效。 |
90039 | 按属性推送和按标签推送不可同时存在。 |
90040 | 推送条件中其中1个 tag 为空。 |
90045 | 未开通全员/标签/单推推送功能。 |
90047 | 推送次数超过当天限额（默认为100次）。 |
90049 | |
90050 | 重复撤回，已经撤回的推送任务不能重复调用。 |
90051 | 撤回过于频繁，撤回限频1次/s。 |
90052 | 超过撤回有效期，撤回要求在24小时内，超过24小时的推送任务无法撤回。 |
90053 | 撤回无效。推送任务指定不存漫游/未读（OnlineOnlyFlag = 0），但是撤回时没有带上 OfflinePushInfo。 |
90056 | 全员推送的请求体过大，目前支持最大10K长度。 |
91000 | 服务内部错误，请重试。 |
客户端错误码
说明：
错误码 | 含义说明 |
800001 | 注册推送服务，appKey 参数不合法。 |
800002 | 注册推送服务，sdkAppId 参数不合法。 |
800003 | 初始化 SDK 失败。 |
800004 | 长链接建立失败。 |
800005 | 本机通道注册推送失败。 |
800006 | 本机通道注册推送失败后，尝试 fcm 通道注册失败。 |
800007 | 探测所有通道失败。 |
800008 | 注册推送服务超时。 |
800009 | 注册推送 token 为空。 |
800010 | 给 SDK 设置 token 失败。 |
800011 | 关闭自动注册失败。 |
800012 | 关闭推送权限请求失败。 |
800013 | 创建通知 channel 失败。 |
800014 | 设置推送配置失败。 |
800015 | 实验性接口调用失败。 |
800016 | 用户拒绝推送获取弹窗权限。 |
6014 | IM 账号未登录，请先登录后再注册推送。 |
9523 | 请检查网络是否正常。 |
70016 | 公钥不存在，UserSig 验证失败，请确认是否使用了正确的 appKey。 |
厂商错误码
说明：
此处仅列出各厂商服务端常见错误码作为参考，如有疑问，请自行咨询对应厂商。
错误码 | 含义说明 |
-1 | 未知错误。 |
0 | 成功。 |
1 | 内部错误。 |
10001 | 系统错误。 |
10002 | 系统繁忙。 |
10003 | 远程服务错误。 |
10008 | 参数错误，请参考 API 文档。 |
10012 | 非法请求。 |
10016 | 缺失必选参数。 |
10017 | 参数值非法。 |
10027 | 应用的 API 调用太频繁。 |
10029 | 不合法的设备。 发起 app 相关操作时，例如注册、取消注册时，找不到对应的设备。 |
10030 | 应用获取失效 regid 太频繁。 |
10031 | 应用在黑名单中，禁止发送消息。 |
10032 | 应用获取失效 alias 太频繁。 |
10033 | 应用在黑名单中，禁止发 feedback 请求。 |
10034 | 应用当日发送消息数量过多。 |
10035 | 没有更多的失效 alias 可供拉取。 |
10036 | 应用操作被禁止。 |
10037 | 请求过期。 |
10038 | 应用禁止访问统计和 trace 数据。 |
10039 | 应用获取消息统计和 trace 太过频繁。 |
20607 | DB 错误。 |
20209 | 不合法的主题。 |
20215 | 订阅主题失败。 |
20216 | 退订主题失败。 |
20301 | 发送消息失败。 |
20315 | 删除广播消息失败。 |
21301 | 认证失败。 |
21302 | token 认证失败。 |
21303 | 被限制的请求。 |
21305 | 缺少必要的参数。 |
22000 | 非法应用。 |
22006 | 应用程序 ID 不合法。 |
22007 | 应用程序 Key 不合法。 |
22022 | 应用程序 package name 不合法。 |
22102 | 发送应用通知消息失败。 |
26003 | 消息 Push 内部调用失败。 |
26004 | 广播消息发送太频繁。 |
26005 | account 设置太频繁而被禁止。 |
26006 | 发送需要审核，请及时审核。 |
27001 | channel 相关信息不匹配。 |
65003 | 未找到 device，通常是设备不在线导致。 |
65006 | 别名设置太频繁而被禁止。 |
65007 | 别名在黑名单中。 |
65008 | 别名长度太长。 |
65009 | 消息内容太长。 |
65010 | 主题长度太长。 |
65011 | 未提供参数。 |
65012 | 别名为空。 |
65013 | 主题为空。 |
65014 | 键值对数目太多。 |
65015 | 键值对总长度太长。 |
65016 | User account 为空。 |
65017 | User account 长度太长。 |
65028 | 未查询到相应消息。 |
65029 | 远程服务异常。 |
65030 | 构建 JSON 时出现异常。 |
65035 | 主题数量太多。 |
65036 | Callback 参数太长。 |
65037 | Callback url 太长。 |
65038 | Callback url 非法。 |
65040 | 注销失败。 |
65041 | ImeiMd5 为空。 |
65042 | ImeiMd5 不合法。 |
66006 | 注册失败。这里指安卓设备注册异常，包括设备注册和应用注册。 |
66007 | regId 非法，指 regId 格式不正确。 |
66008 | 不合法的请求。 |
66108 | 发送的参数信息不合法。 |
66109 | regSecret 无效。 |
66300 | 未知的命令。 |
66301 | 执行命令出错。 |
66303 | 小米 ID 为空。 |
66304 | 小米 ID 太长。 |
66305 | 不合法的小米 ID。 小米 ID 的格式不正确。 |
66306 | 关闭或打开 push 失败。 |
66307 | 删除定时任务 job 时传入的消息 ID 无效。 |
66308 | 打分服务请求参数违法。 |
70011 | 输入为空。 |
70012 | JobKey 格式不合法。 |
200001 | 推送数量超过当日限额。 |
200002 | 推送 QPS 超过限额。 |
错误码 | 含义说明 |
-5 | 获取 Token 任务失败。 |
502 | 请求连接异常，常见于网络状况不稳定。 |
503 | 流量控制。 |
6003 | 指纹证书配置不一致。 |
6004 | 接口鉴权时，权限不存在。 |
80100003 | 消息结构体错误。 |
80100016 | 消息体中带有敏感词汇。 |
80300002 | 下发消息给指定的用户（Token）报无权限。 |
80300007 | 指定的 Token 无效。 |
907122036 | 没有开通推送权益。 |
907122046 | Push 不可服务。 |
907122047 | 通用错误码。 |
907122054 | Push SDK 自动初始化中，请稍后重试操作。 |
907122069 | 不支持子用户操作。 |
907135000 | 传入的参数错误。 |
907135003 | SDK 连接 HMS Core（APK）失败。 |
907135700 | 调用网关查询应用 scope 失败。 |
907135701 |
错误码 | 含义说明 |
-2 | 服务器流量控制。 |
-1 | 服务不可用，此时请开发者稍候再试。 |
0 | 成功，表明接口调用成功。 |
11 | 不合法的 AuthToken。 |
12 | HTTP 方法不正确。 |
13 | 应用调用次数超限，包含调用频率超限。 |
14 | 无效的 AppKey 参数。 |
15 | 缺少 AppKey 参数。 |
16 | sign 校验不通过，无效签名。 |
17 | 缺少签名参数。 |
18 | 缺少时间戳参数。 |
19 | 非法的时间戳参数。 |
20 | 不存在的方法名。 |
21 | 缺少方法名参数。 |
22 | 缺少版本参数。 |
23 | 非法的版本参数，用户传入的版本号格式错误，必需为数字格式。 |
24 | 不支持的版本号，用户传入的版本号没有被提供。 |
25 | 编码错误，一般是用户做 http 请求的时候没有用 UTF-8 编码请求造成的。 |
26 | IP 黑名单。 |
27 | 没有此功能的权限，拒绝访问。 |
28 | 应用不可用。 |
29 | 缺少 Auth Token 参数。 |
30 | 该应用没有 API 推送的权限。 |
31 | 数据不存在。 |
32 | 数据重复。 |
33 | 消息条数超过日限额。 |
34 | 上传图片超过日限额。 |
40 | 缺少必选参数，API 文档中设置为必选的参数是必传的，请仔细核对文档。 |
41 | 参数错误，一般是用户传入参数非法引起的，请仔细检查入参格式、范围是否一一对应。 |
51 | 图片无效，一般是图片格式、图片分辨率、图片大小不符合格式及图片未上传等，请仔细检查图片格式及上传文件方式。 |
55 | 应用访问频率限制。 |
59 | 无备用链接跳转权限，拒绝访问。 |
67 | 分类错误（包含强提醒所有异常）。 |
错误码 | 含义说明 |
0 | 请求成功。 |
10000 | 权限认证失败。 |
10006 | 别名长度超过 70 个字符。 |
10043 | 该应用已关闭 push 通道。 |
10045 | 应用审核中不可发送正式消息。 |
10050 | alias 和 regId 不能都为空。 |
10051 | classification 暂不支持该消息类型。 |
10054 | notifyType 不合法。 |
10055 | title 不能为空。 |
10056 | title 长度不能超过40个字符。 |
10057 | content 不能为空。 |
10058 | content 长度不能超过100个字符。 |
10059 | timeToLive 不合法。 |
10060 | skipType 不合法。 |
10061 | skipType = 2，skipContent 不能为空。 |
10062 | skipType = 2，skipContent 不能超过2048个字符。 |
10063 | skipType = 3，skipContent 不能为空。 |
10064 | skipType = 3，skipContent 不能超过2048个字符。 |
10065 | networkType 不合法。 |
10067 | 自定义 key 和 value 键值对不合法。 |
10068 | skipType = 4，skipContent 不能为空。 |
10069 | skipType = 4，skipContent 不能超过2048个字符。 |
10070 | 运营消息发送量总量超出限制。 |
10071 | 超出发送时间允许范围。 |
10072 | 推送速度过快，请稍后再试。 |
10073 | 系统消息发送量总量超出限制。 |
10082 | 系统消息开关未打开。 |
10092 | profileId 长度超过限制。 |
10094 | 鉴权码与请求体对应的 AppID 不一致。 |
10095 | notifyId 非法。 |
10096 | category 错误。 |
10097 | category 与 classification 不对应。 |
10103 | 推送内容含敏感信息。 |
10104 | 请发送正式消息。 |
10150 | aliases 和 regIds 不能都为空。 |
10151 | taskId 不能为空。 |
10152 | taskId 不合法。 |
10153 | regIds 个数不在指定范围[2-1000]。 |
10154 | aliases 个数不在指定范围[2-1000]。 |
10155 | 消息不存在或已过期。 |
10200 | AppID 不能为空。 |
10201 | appKey 不能为空。 |
10202 | appKey 不合法。 |
10203 | timestamp 不能为空。 |
10204 | sign 不能为空。 |
10205 | AppID 不存在。 |
10206 | sign 不正确。 |
10207 | timestamp 不合法。 |
10252 | 批量发送消息体超出限制。 |
10255 | 全量推送接口未开放。 |
10301 | alias 长度不能超过70个字符 |
10302 | regId 不合法 。 |
10304 | extra 包含不支持的 key。 |
10305 | extra callback 长度超限。 |
10306 | extra callback.param 长度超限。 |
10307 | alias 不合法。 |
10311 | 该设备当前无法推送。 |
10352 | requestId 不能为空。 |
10353 | requestId 长度不能超过 64 个字符。 |
10471 | taskIds 数量不能超过 100 个。 |
10472 | taskIds 格式错误。 |
10473 | taskIds 为空。 |
10600 | name 参数不合法。 |
10601 | 标签名字不能为空。 |
10602 | 标签描述不能超过 300 字符。 |
10603 | oldName 参数不能为空。 |
10604 | newName 参数不能为空。 |
10605 | oldName 参数不合法。 |
10606 | newName 参数不合法。 |
10608 | type 参数不能为空。 |
10609 | ids 参数不能为空。 |
10610 | 标签名已经存在。 |
10611 | 标签分类名已经存在。 |
10612 | 标签组合名已经存在。 |
10613 | group 参数不合法。 |
10614 | ids 数量不能超过1000。 |
10615 | tag 数量不能超过100。 |
10616 | type 参数不合法。 |
10700 | userids 不能为空。 |
10701 | UserID 个数超过限制。 |
10703 | 超过上限，稍后再试。 |
10704 | requestId 长度不能超过 64 个字符。 |
10706 | userType 错误。 |
10800 | registration_tokens 个数不在指定范围。 |
10801 | notification 不能为空。 |
10802 | original_source_name 不能为空。 |
10803 | original_source_name 长度非法。 |
10804 | original_source_ip 不能为空。 |
10806 | click_action 非法。 |
10807 | url 长度超过限制。 |
10808 | intent 长度超过限制。 |
错误码 | 含义说明 |
200 | 正常。 |
500 | 其他异常。 |
1001 | 系统错误。 |
1003 | 服务器忙。 |
1005 | 参数错误，请参考 API 文档。 |
1006 | 签名认证失败。 |
110000 | AppID 不合法。 |
110001 | appKey 不合法。 |
110004 | 参数不能为空。 |
110009 | 应用被加入黑名单。 |
110010 | 应用推送速率过快。 |
110053 | 透传超过限制。 |
201 | 没有权限，服务器主动拒绝。 |
501 | 推送消息失败（db_error）。 |
513 | 推送消息失败。 |
519 | 推送消息失败服务过载。 |
520 | 消息折叠（1分钟内同一设备同一应用消息收到多次，默认5次）。 |
110002 | pushId 失效( pushId 未订阅)。 |
110003 | pushId 非法。 |
110005 | alias 失效( alias 未订阅或者消息开关关闭)。 |
110010 | pushId 失效(消息开关关闭)。 |
错误码 | 含义说明 |
200 | 成功。 |
400 | 参数错误。 |
403 | 鉴权不通过。 |
404 | 找不到服务。 |
500 | 服务内部错误。 |
502 | 请求连接异常，常见于网络状况不稳定。 |
503 | 请求频繁，请重试。 |
80100000 | 部分Token发送成功，返回的 failTokens 为发送失败的 Token。 |
80100003 | 消息结构体错误。 |
80300006 | Token 重复。 |
80300007 | 所有 Push Token 都是无效的。 |
80300008 | 消息体大小超过系统设置的默认值（4096 Bytes）。 |
80300010 | 每次推送 Push Token 数量不能超过 1000。 |
80200020 | 回执不匹配。 |
10001 | timestamp 为空。 |
10207 | timestamp 不合法。 |
10300 | Token 为空。 |
10205 | appId 为空。 |
错误码 | 含义说明 |
400 | INVALID_ARGUMENT，可能的原因包括注册无效、软件包名称无效、消息过大、数据键无效、TTL 无效或其他无效参数。 |
404 | UNREGISTERED， 出现此错误的原因可能是缺少注册令牌，或令牌未注册。 |
403 | SENDER_ID_MISMATCH， 一个注册令牌与一组特定的发送者关联。当客户端应用注册 FCM 时，必须指定允许哪些发送者发送消息。在向客户端应用发送消息时，您应使用这些发送者 ID 之一。如果您切换为其他发送者，则现有的注册令牌将不起作用。 |
429 | QUOTA_EXCEEDED， 此错误可能是由超出消息率配额、超出设备消息率配额或超出主题消息率配额导致的。 |
503 | UNAVAILABLE，服务器无法及时处理请求。 |
500 | INTERNAL，服务器在尝试处理请求时遇到错误。 |
错误码 | 含义说明 |
200 | 成功。 |
403 | BadCertificate， 证书无效。 |
| BadCertificateEnvironment， 客户端证书环境错误。 |
| ExpiredProviderToken，提供商令牌已过时，应生成新的令牌。 |
| InvalidProviderToken，提供商令牌无效，或者无法验证令牌签名。 |
410 | ExpiredToken， 设备令牌已过期。 |
