响应示例
响应成功示例：
{
"code": "80000000",
"msg": "Success",
"requestId": "157*******006"
} 响应失败示例：
{
"code": "80100003",
"msg": "Illegal payload, badge addNum value ranges from 1 to 99",
"requestId": "1690*******1701"
} 业务响应码
通过业务响应码定位问题之前，请优先检查消息推送接口URL（https://push-api.cloud.huawei.com/v3/[projectId]/messages:send）是否正确：
-
请使用v3版本的推送接口URL，不建议使用v1或v2版本的推送接口URL，详情请参见场景化消息中的请求URL版本问题。
-
请检查推送接口地址中的projectId，确保与您当前应用所属的项目保持一致，若不一致请更新推送接口URL中的projectId，并重新生成鉴权令牌，应用重新获取Push Token，再进行消息推送。
[h2]80100000 部分Token发送成功
错误信息
Check Parameter Partial Success.
错误描述
部分Token发送成功。
可能原因
-
noPushTypeRight：未申请请求头中push-type对应场景的权益。
-
noRight：生成Push Token的应用不属于请求url中projectId对应的项目。
-
atomicUnableSendUnsubscribedMsg：元服务不支持本次请求中对应的消息场景。
-
tokenFormatError：Token格式错误。
-
countryNotSupport：国家不支持。
-
tokenPlatformNotSupport：不支持三方代理Token。
-
disableSendHuaweiMsgBecauseOfPenalty：应用被违规处罚。
-
appinfoError：应用未创建。
-
noRightToSendThisLiveNotificationEvent：没有申请对应实况窗场景的权益。
处理步骤
请根据响应消息中的提示，排查失败的Token是否存在以下情况：
-
noPushTypeRight：请开通请求头中push-type对应场景的权益，语音播报消息（push-type为2）权益申请可参考申请推送语音播报消息权益，应用内通话消息（push-type为10）权益申请可参考申请推送应用内通话消息权益。
-
noRight：请检查生成Push Token的应用是否属于请求url中projectId对应的项目，即确保请求URL（https://push-api.cloud.huawei.com/v3/[projectId]/messages:send）中的projectId与AppGallery Connect网站中该应用所属的“项目ID”一致。
-
atomicUnableSendUnsubscribedMsg：元服务仅支持发送授权订阅消息、卡片刷新消息，请排查消息体内容。
-
tokenFormatError：请检查Push Token格式是否错误，并重新申请Push Token。
-
countryNotSupport：请通过在线提单提交问题。
-
tokenPlatformNotSupport：请重新申请Push Token。
-
disableSendHuaweiMsgBecauseOfPenalty：请在AppGallery Connect网站上检查并处理违规后再尝试发送消息。
-
differentImgVerifyPolicy：请确保图片风控使用的push-type与推送时的push-type一致。
-
appinfoError：请在AppGallery Connect网站上检查应用是否创建，如果应用已成功创建，请稍后重试。
-
noRightToSendThisLiveNotificationEvent： 请参见开通实况窗权益完成权益的申请。
响应示例：
{
"code": "80100000",
"msg": "{\"illegalTokens\":{\"tokenFormatError\":[\"MAAALgE4G98BAAAAst*******jg\"]},\"success\":1,\"failure\":1}",
"requestId": "1690*******1701"
} [h2]80100001 请求参数部分错误
错误信息
Check Parameter Error.
错误描述
请求参数部分错误。
可能原因
请求参数部分错误。
处理步骤
请根据响应消息中的提示，检查并修改请求参数内容。
[h2]80100003 消息结构体错误
错误信息
Illegal payload, {errorTips}.
错误描述
消息结构体错误。
可能原因
消息结构体错误。
处理步骤
请根据响应消息中的提示，检查并修改请求体结构。
[h2]80100022 消息携带图片未验签
错误信息
Anti-Spam: image not verify.
错误描述
消息携带图片未验签。
可能原因
消息图片未经过风控验证。
处理步骤
请根据响应消息中的提示，检查消息图片是否正常经过风控验证，对下发的图片进行风控校验。
[h2]80100024 图片风控已过期
错误信息
Anti-Spam: verify image expire.
错误描述
图片风控已过期。
可能原因
用过期的风控后的downloadUrl发送消息。
处理步骤
请根据响应消息中的提示，对下发的图片重新进行风控校验。
[h2]80200001 认证错误
错误信息
Authentication Error.
错误描述
认证错误。
可能原因
-
发送消息时未添加Authorization参数或Authorization的值为空。
-
用于申请JWT Token的Project Id和推送消息的Project Id不一致。
-
Authorization参数中的JWT Token与实际应用不匹配。
-
未使用v3版本接口发送REST API请求。
-
HarmonyOS 5及以上系统版本推送不再支持Oauth2.0开放鉴权，请使用JWT（JSON Web Tokens）鉴权。
处理步骤
请根据响应消息中的提示，排查请求头中Authorization参数鉴权失败是否存在以下情况：
-
请检查发送消息时是否添加Authorization参数或Authorization的值为空。
-
请参考鉴权令牌生成步骤中的步骤二，检查推送请求URL（https://push-api.cloud.huawei.com/v3/[projectId]/messages:send）中的projectId，确保与您当前应用所属的项目保持一致。
-
请检查Authorization参数中的JWT Token与实际应用是否匹配，详情参见基于服务账号生成鉴权令牌。
-
请使用v3版本的请求URL（https://push-api.cloud.huawei.com/v3/[projectId]/messages:send）发送REST API请求。
-
使用JWT（JSON Web Tokens）方式生成令牌后再推送消息。
[h2]80200005 JWT Token过期
错误信息
Jwt token expired.
错误描述
JWT Token过期。
可能原因
JWT Token过期。
处理步骤
请根据响应消息中的提示，重新生成JWT Token后再推送消息，请参见基于服务账号生成鉴权令牌。
[h2]80300002 当前应用无权限下发推送消息
错误信息
No permission to send message to these tmIDs.
错误描述
当前应用无权限下发推送消息。
可能原因
-
推送服务未开通。
-
推送服务已开通，但推送请求URL中的projectId与当前应用所属的项目不一致。
处理步骤
-
请登录AppGallery Connect网站，查看推送服务是否已开通，请参见开通推送服务。
-
请参考鉴权令牌生成步骤中的步骤二，检查推送请求URL（https://push-api.cloud.huawei.com/v3/[projectId]/messages:send）中的projectId，确保与您当前应用所属的项目保持一致。
请确保当前应用所属的项目已开通了推送服务，并基于该项目重新生成鉴权令牌，并重新尝试推送消息。
[h2]80300007 所有Token都是无效的
错误信息
All the tokens are invalid.
错误描述
所有Token都是无效的。
可能原因
-
noPushTypeRight：未申请请求头中push-type对应场景的权益。
-
noRight：生成Push Token的应用不属于请求url中projectId对应的项目。或终端设备从HarmonyOS 4及以下版本（简称HarmonyOS）升级到HarmonyOS 5及以上版本（简称HarmonyOS NEXT）后，Push Token未重新获取或请求URL版本未更新至V3版本。
-
atomicUnableSendUnsubscribedMsg：元服务不支持本次请求中对应的消息场景。
-
tokenFormatError：Token格式错误。
-
countryNotSupport：国家不支持。
-
tokenPlatformNotSupport：不支持三方代理Token。
-
disableSendHuaweiMsgBecauseOfPenalty：应用被违规处罚。
-
appinfoError：应用未创建。
-
notSupportPlayVoice：推送自分类类型为PLAY_VOICE（语音播报）的语音播报消息时，请求头中push-type传入错误。
-
noRightToSendThisLiveNotificationEvent：没有申请对应实况窗场景的权益。
处理步骤
请根据响应消息中的提示，排查失败的Token是否存在以下情况
-
noPushTypeRight：请开通请求头中对应push-type场景的权益，语音播报消息（push-type为2）权益申请可参考申请推送语音播报消息权益，应用内通话消息（push-type为10）权益申请可参考申请推送应用内通话消息权益。
-
noRight：请检查生成Push Token的应用是否属于请求url中projectId对应的项目，即确保请求URL（https://push-api.cloud.huawei.com/v3/[projectId]/messages:send）中的projectId与AppGallery Connect网站中该应用所属的“项目ID”一致。
若终端设备升级至HarmonyOS NEXT版本后，需重新生成对应的Push Token（建议您在应用启动时调用getToken接口，若设备的Push Token发生变化，及时上报到您的应用服务器更新Push Token）。并使用请求体参数说明、V3版本的请求URL（https://push-api.cloud.huawei.com/v3/[projectId]/messages:send）发送REST API请求。
-
atomicUnableSendUnsubscribedMsg：元服务仅支持发送授权订阅消息、卡片刷新消息，请排查消息体内容。
-
tokenFormatError：请检查Push Token格式是否错误，并重新申请Push Token。
-
countryNotSupport：请通过在线提单提交问题。
-
tokenPlatformNotSupport：请重新申请Push Token。
-
disableSendHuaweiMsgBecauseOfPenalty：请在AppGallery Connect网站上检查并处理违规后再尝试发送消息。
-
differentImgVerifyPolicy：请确保图片风控使用的push-type与推送时的push-type一致。
-
appinfoError：请在AppGallery Connect网站上检查应用是否创建，如果应用已成功创建，请稍后重试。
-
notSupportPlayVoice：若应用需要推送自分类类型为PLAY_VOICE（语音播报）的消息时，需使用语音播报消息进行推送，即请求头中push-type传入2，表示语音播报消息。
-
noRightToSendThisLiveNotificationEvent： 请参见开通实况窗权益完成权益的申请。
响应示例：
{
"code": "80300007",
"msg": "{\"failure\":2,\"illegalTokens\":{\"noRight\":[\"MAAALgE4G98BAAAAst*******jg\",\"MAAALgE4G98BAAAAst*******re\"]}}",
"requestId": "1690*******1701"
} [h2]80300008 消息体大小超过4096Bytes（不包括Push Token）
错误信息
Push message size is too long.
错误描述
消息体大小超过4096Bytes（不包括Push Token）。
可能原因
请求消息体大小超过4096Bytes（不包括Push Token）。
处理步骤
请根据响应消息中的提示，减小消息体后重新发送消息。
[h2]80300010 消息体中的Token数量超过系统设置的默认值
错误信息
token count should within {0} and {1}.
错误描述
消息体中的Token数量超过系统设置的默认值。
可能原因
-
卡片刷新消息单次发送消息仅能携带1个Token。
-
其余场景单次发送消息最多携带1000个Token。
处理步骤
请根据响应消息中的提示，请减少Token数量后分批发送消息。
[h2]80300029 测试消息请求流量限制
错误信息
When send test message, the api request exceed limit.
错误描述
测试消息请求流量限制。
可能原因
测试消息发送过于频繁。
处理步骤
请根据响应消息中的提示，稍后再发送。
[h2]80300030 测试消息单次携带Token数量超过系统设置的默认值
错误信息
When send test message, token count exceed limit.
错误描述
测试消息单次携带Token数量超过系统设置的默认值。
可能原因
-
卡片刷新消息单次发送测试消息仅能携带1个Token。
-
其余场景单次发送测试消息最多携带10个Token。
处理步骤
请根据响应消息中的提示，减少Token数量后再发送消息。
[h2]80300036 JWT有效期超过1天
错误信息
JWT expire period over threshold.
错误描述
JWT有效期超过1天。
可能原因
JWT有效期超过1天。
处理步骤
请根据响应消息中的提示，重新生成有效期小于1天的JWT Token后再推送消息。
[h2]80300037 由于存在违规处罚导致无法发送推送消息
错误信息
Disable send huawei msg because of penalty.
错误描述
由于存在违规处罚导致无法发送推送消息。
可能原因
由于存在违规处罚导致无法发送推送消息。
处理步骤
请根据响应消息中的提示，先在AppGallery Connect网站上处理违规后再尝试发送消息。