Erros
Todo erro da NOD API tem o mesmo formato. Use o campo code para decidir o que fazer; a mensagem pode mudar.
Formato
{
"statusCode": 429,
"code": "RATE_LIMITED",
"message": "Muitas requisições. Tente novamente em instantes."
}Códigos
| HTTP | code | Mensagem | O que fazer |
|---|---|---|---|
| 401 | INVALID_KEY | Chave de API inválida ou ausente. | Chave errada, ausente ou trocada. Não repita; gere a chave de novo no painel. |
| 402 | PLAN_INACTIVE | Acesso indisponível para esta conta. | A conta está sem plano ativo. Não repita; regularize no painel. |
| 403 | CONNECTION_REVOKED | Esta conexão não está mais ativa. | A conexão foi suspensa ou revogada. Não repita. |
| 403 | SEAT_EXCEEDED | Conexão acima das vagas do plano. Ela volta quando houver vaga. | A conexão está acima das vagas do plano e volta sozinha quando sobra vaga. Repita só depois. |
| 404 | NOT_ALLOWED | Recurso não encontrado. | Rota que não existe na API pública, ou chave do outro tipo de conexão. Corrija a chamada. |
| 413 | PAYLOAD_TOO_LARGE | Corpo da requisição grande demais. | O corpo passou do tamanho máximo. Envie menos dados. |
| 429 | RATE_LIMITED | Muitas requisições. Tente novamente em instantes. | Espere o tempo do header Retry-After (segundos) e repita. |
| 502 | UPSTREAM_UNAVAILABLE | Serviço temporariamente indisponível. | Serviço fora do ar por instantes. Repita com espera crescente (5 s, 30 s, 2 min). |
| 504 | UPSTREAM_TIMEOUT | O serviço demorou demais para responder. | O serviço demorou demais. Repita com espera crescente só se a operação puder se repetir sem efeito duplicado. |
Erros do WhatsApp
Quando o próprio WhatsApp (ou a Meta, na API oficial) recusa a chamada, a resposta volta como veio, com o status e o corpo dele, sem este formato. Na /meta/* é o erro nativo da Meta ({"error":{"code":…}}).