Todos os produtos
Search
Central de documentação

Mobile Platform as a Service:Códigos de status de push de mensagens

Última atualização: Jun 28, 2026

Lista os códigos de status comuns de push de mensagens e os códigos de cada canal de push.

Códigos de status comuns de push de mensagens

Código de status

Descrição

Explicação

-1

WaitingForVerify

Aguardando verificação.

0

DeviceNotOnlineOrNoResponse

O dispositivo de destino está offline (a conexão persistente com o gateway do Mobile Push foi desconectada) ou nenhuma confirmação de envio foi recebida.

1

NoBindInfo

Não existe relação de vinculação. Ao enviar mensagens por ID de usuário, certifique-se de que o ID de usuário de destino esteja vinculado a um ID de dispositivo.

2

Acked

Em canais próprios, a mensagem foi enviada com sucesso ao cliente. Em canais de terceiros, o gateway de push foi chamado com sucesso.

99999999

NONE

Status desconhecido.

Canal de push da Apple

Código de status

Descrição

Explicação

2001

PayloadEmpty

O corpo da mensagem está vazio.

2002

PayloadTooLarge

O corpo da mensagem é muito grande.

2003

BadTopic

O bundle ID no certificado está incorreto.

2004

TopicDisallowed

O bundle ID no certificado é inválido.

2005

BadMessageId

O messageId está incorreto.

2006

BadExpirationDate

A data de expiração é inválida.

2007

BadPriority

Peso inválido.

2008

MissingDeviceToken

O token do dispositivo está ausente.

2009

BadDeviceToken

O token do dispositivo é inválido, tem formato incorreto ou não existe. Se esse erro ocorrer ao enviar mensagens por dimensão de usuário, verifique se o token usado para vinculação está correto. Após a vinculação, crie uma mensagem de push minimalista no console do Mobile Push para teste.

No ambiente de desenvolvimento (com certificado de desenvolvimento configurado no console), use um certificado pessoal de desenvolvimento para empacotar o aplicativo para testes. Caso contrário, o erro BadDeviceToken ocorre.

2010

DeviceTokenNotForTopic

O token do dispositivo e o certificado não correspondem.

2011

Unregistered

O token expirou.

2013

BadCertificateEnvironment

O ambiente do certificado é inválido.

2014

BadCertificate

O certificado é inválido.

2023

MissingTopic

Nenhum tópico especificado.

2024

ConnClosed

A conexão APNs foi desconectada. Possíveis causas:

  • O ambiente do certificado de push da Apple configurado no console não corresponde ao token do dispositivo usado no push.

  • O certificado empacotado no pacote de instalação do aplicativo não corresponde ao certificado configurado no console.

  • O bundle ID no projeto difere do bundle ID configurado no console.

Para obter informações sobre como configurar certificado de push iOS, ambiente de certificado e bundle ID no console, consulte Configurar um certificado de push iOS.

2025

ConnUnavailable

A conexão APNs não foi estabelecida.

Canal de push da Huawei

Código de status

Descrição

100

Parâmetro desconhecido inválido.

101

API_KEY inválido.

102

SESSION_KEY inválido.

106

O aplicativo ou sessão não tem permissão para chamar o serviço atual.

107

O client e o secret devem ser obtidos novamente (por exemplo, devido a atualização de algoritmo).

109

O desvio nsp_ts é muito grande.

110

Erro interno de API.

111

Serviço ocupado.

80000003

Dispositivo offline.

80000004

Aplicativo desinstalado.

80000005

Tempo limite da resposta excedido.

80000006

Sem rota. O dispositivo não se conectou ao Push.

80000007

O dispositivo está em outra região e não usa o Push na China continental.

80000008

Rota incorreta. O dispositivo pode ter alternado para outro servidor Push.

80100000

Falha na validação de parâmetros. Alguns parâmetros estão incorretos.

80100002

Lista de tokens inválida.

80100003

Payload inválido.

80100004

Período de tempo limite inválido.

80300002

Sem permissão para enviar mensagens à lista de tokens nos parâmetros.

80300007

Todos os tokens na solicitação são inválidos.

81000001

Erro interno.

80300008

Erro de autenticação (corpo da mensagem de solicitação muito grande).

Canal de push da Honor

Código de status

Descrição

Explicação

200

Sucesso

Não aplicável.

400

Erro de parâmetro

Verifique o código de erro na resposta e solucione o problema com base nele.

403

Falha na autenticação

Verifique se o access token está correto.

404

Serviço não encontrado

Verifique se a URI da solicitação está correta.

500

Erro interno do serviço

Verifique se o método de solicitação e o formato da mensagem estão consistentes com a documentação. Se o problema persistir, envie a mensagem detalhada para honorpush@honor.com.

502

Conexão da solicitação anormal. Comum quando a rede está instável.

Tente novamente mais tarde.

503

request too many,please try again later

Limite máximo de QPS (3.000 por aplicativo) excedido. Tente novamente mais tarde.

80100000

Alguns tokens foram enviados com sucesso. Os failTokens retornados indicam as falhas no envio.

Verifique os tokens com falha no valor de retorno.

80100003

Erro na estrutura da mensagem

Verifique os parâmetros da estrutura da mensagem conforme indicado na resposta.

80300006

push token is repeat

Verifique se há pushTokens duplicados.

80300007

Todos os tokens são inválidos.

Tokens de aplicativos diferentes no mesmo dispositivo costumam ser distintos, mas o mesmo valor pode ter sido passado por engano. O nome do pacote e o ID do aplicativo configurados no cliente divergem dos solicitados. Verifique se a URL para obter o access_token e a URL para enviar a mensagem estão corretas.

80300008

O tamanho do corpo da mensagem excede o padrão do sistema (4.096 bytes).

A mensagem de solicitação excede o valor padrão. Reduza o tamanho da mensagem e reenvie.

80300010

O número de tokens de push por envio não pode exceder 1.000.

Verifique se o número de tokens de push excede 1.000.

80200020

receipt id is not match

O receiptId não corresponde.

10001

timestamp is null

Verifique o timestamp.

10207

Timestamp inválido.

Obtenha o timestamp válido atual e verifique sua validade.

10300

push token is null

Insira o pushToken.

10205

appId is not found

O appId não existe.

Para obter mais informações, consulte Referência de códigos de erro do Honor Push.

Canal de push da Xiaomi

Código de status

Descrição

10001

Erro do sistema.

10002

Serviço suspenso.

10003

Erro de serviço remoto.

10004

Endereço IP sem permissão para solicitar este recurso.

10005

O appkey precisa de autorização para acessar este recurso.

10008

Erro de parâmetro.

10009

Sistema ocupado.

10012

Solicitação inválida.

10013

Usuário inválido.

10014

Permissões de acesso à API restritas para o aplicativo.

10017

Valor do parâmetro inválido.

10018

Tamanho da solicitação excede o limite.

10022

Frequência de solicitações do endereço IP excede o limite.

10023

Frequência de solicitações do usuário excede o limite.

10024

Frequência de solicitações do usuário para uma API específica excede o limite.

10026

Aplicativo na lista de bloqueios; chamada de API proibida.

10027

Aplicativo chama a API com frequência excessiva.

10029

Dispositivo inválido.

21301

Falha na autenticação.

22000

Aplicativo inválido.

22001

Aplicativo inexistente.

22002

Aplicativo revogado.

22003

Falha ao atualizar o aplicativo.

22004

Informações do aplicativo ausentes.

22005

Nome do aplicativo inválido.

22006

ID do aplicativo inválido.

22007

Chave do aplicativo inválida.

22008

Secret do aplicativo inválido.

22020

Descrição do aplicativo inválida.

22021

Usuário não concedeu autorização ao aplicativo.

22022

Nome do pacote do aplicativo inválido.

22100

Formato de dados da notificação do aplicativo inválido.

22101

Excesso de mensagens de notificação do aplicativo.

22102

Falha ao enviar mensagem de notificação do aplicativo.

22103

ID da notificação do aplicativo inválido.

20301

Destino especificado inválido.

Canal de push da OPPO

Código de status

Descrição

Explicação

-1

Service Currently Unavailable

Serviço indisponível. Tente novamente mais tarde.

-2

Service in Flow Control

Limitação de taxa no lado do servidor.

11

Invalid Auth Token

AuthToken inválido.

13

App Call Limited

Número de chamadas do aplicativo excede o limite (inclui limite de frequência).

14

Invalid App Key

Parâmetro AppKey inválido.

15

Missing App Key

Parâmetro AppKey ausente.

16

Invalid Signature

Falha na verificação de assinatura. Assinatura inválida.

17

Missing Signature

Falha na verificação de assinatura. Assinatura ausente.

28

App Disabled

Aplicativo indisponível.

29

Missing Auth Token

Parâmetro Auth Token ausente.

30

Api Permission Denied

Aplicativo sem permissão para push via API.

10000

Invalid RegistrationId

Formato do registration_id incorreto.

Canal de push da vivo

Código de status

Descrição

10000

Falha na autenticação de permissão.

10040

Limite de recursos atingido. Tente novamente mais tarde.

10050

Alias e regId não podem estar ambos vazios.

10055

Título não pode estar vazio.

10056

Título não pode exceder 40 caracteres.

10058

Conteúdo não pode exceder 100 caracteres.

10066

Máximo de 10 pares chave-valor personalizados.

10067

Pares chave-valor personalizados inválidos.

10070

Total de mensagens enviadas excede o limite.

10071

Horário de envio fora do intervalo permitido.

10072

Velocidade de push muito rápida. Tente novamente mais tarde.

10101

Conteúdo da mensagem reprovado na moderação.

10102

Exceção desconhecida no servidor vivo.

10103

Conteúdo do push contém informações sensíveis.

10110

Configure a frequência de envio para mensagens comerciais.

10302

RegId inválido. Pode ter expirado.

10303

RequestId já existe.

10104

A mensagem deve conter conteúdo real. Não envie conteúdo de teste. O corpo da mensagem não pode consistir apenas em números, letras ou símbolos, nem combinar símbolos e números. Não pode conter a palavra "test", chaves ou colchetes.

Para obter mais informações, consulte Referência de códigos de erro do vivo Push.

Canal de push FCM

Código de status

Descrição

Explicação

90000002

nvalidRegistration

Destino inválido.

90000003

NotRegistered

Destino não registrado.

90000004

InvalidPackageName

Nome de pacote inválido.

90000007

MessageTooBig

Corpo da mensagem muito grande.

90000009

InvalidTtl

Tempo de vida (TTL) offline inválido.

90000011

InternalServerError

Exceção no serviço FCM.

90000401

Authentication

Acesso negado.

Canal de push HarmonyOS

Código de status

Descrição

Explicação

80000000

Enviado com sucesso

Não aplicável.

80100000

Alguns tokens enviados com sucesso

Os tokens com falha aparecem no campo msg da resposta. Verifique se apresentam os seguintes problemas:

  • noPushTypeRight: Sem direitos para o cenário push-type.

  • noRight: Serviço de push não ativado.

  • atomicUnableSendUnsubscribedMsg: Serviços atômicos não suportam envio.

  • tokenFormatError: Formato do token incorreto.

  • countryNotSupport: País não suportado.

  • tokenPlatformNotSupport: Tokens de agentes de terceiros não suportados.

  • disableSendHuaweiMsgBecauseOfPenalty: Aplicativo penalizado por violação.

  • differentImgVerifyPolicy: O push-type usado no controle de risco de imagem difere do push-type usado no push.

80100001

Parâmetros da solicitação incorretos

Verifique os parâmetros da solicitação conforme indicado na resposta.

80100003

Erro na estrutura da mensagem

Verifique o conteúdo da estrutura da mensagem conforme indicado na resposta.

80100004

Tempo de expiração da mensagem anterior ao horário atual.

Verifique o campo ttl da mensagem.

80100016

Conteúdo da mensagem reprovado na validação

Verifique os campos correspondentes quanto a palavras proibidas, conforme indicado na resposta.

80100022

Assinatura da imagem na mensagem não verificada

Verifique se a imagem da mensagem passou na validação de controle de risco.

80200001

Erro de autenticação

Falha na autenticação do parâmetro Authorization no cabeçalho da solicitação. Verifique:

  1. Parâmetro Authorization não adicionado ou vazio no envio da mensagem.

  2. ID do projeto usado para solicitar o JSON Web Token (JWT) difere do ID do projeto usado na mensagem de push.

80200005

JWT expirado

Regenere o JWT e envie a mensagem de push.

80300002

Aplicativo sem permissão para enviar mensagens de push

  • Faça login no site AppGallery Connect e verifique se o serviço Push está ativado.

  • Token do usuário não corresponde ao token do aplicativo.

  • Verifique erros de entrada no corpo da mensagem.

80300007

Todos os tokens inválidos

  • Tokens de aplicativos diferentes no mesmo dispositivo costumam ser distintos, mas o mesmo valor pode ter sido passado por engano.

  • Nome do pacote e ID do aplicativo configurados no cliente divergem dos solicitados no site AppGallery Connect.

  • Os tokens com falha aparecem no campo msg da resposta. Para detalhes, consulte a descrição do código de status 80100000.

80300008

Tamanho do corpo da mensagem (excluindo tokens) excede o padrão do sistema (4.096 bytes)

A mensagem de solicitação excede o valor padrão. Reduza o tamanho da mensagem e reenvie.

80300010

Número de tokens no corpo da mensagem excede o padrão do sistema

Mensagens únicas para assinaturas autorizadas ou atualizações de cartão aceitam apenas um token.

Nos demais cenários, uma única mensagem aceita até 1.000 tokens.

Reduza o número de tokens e envie as mensagens em lotes.

80300029

Limite de tráfego para solicitações de mensagens de teste

Envio frequente de mensagens de teste. Reenvie mais tarde.

80300030

Número de tokens em mensagem de teste única excede o padrão do sistema

Mensagens de teste únicas para assinaturas autorizadas ou atualizações de cartão aceitam apenas um token.

Nos demais cenários, uma mensagem de teste única aceita até 10 tokens.

Reduza o número de tokens e reenvie a mensagem.

80300036

JWT válido por mais de um dia

Gere um JWT com validade inferior a um dia e envie a mensagem de push.

80300037

Envio de push bloqueado por penalidade de violação

Resolva a violação no site AppGallery Connect antes de tentar enviar mensagens novamente.

81000001

Erro interno do sistema

Envie um ticket online para relatar o problema.

Para obter mais informações, consulte Referência de códigos de erro do HarmonyOS Push.