Erros
Todo erro vem em JSON, com uma frase em error:
{ "error": "Recurso não encontrado." }Quando o problema é de campo, vem também o mapa por campo, em errors — um para quem está
lendo, o outro para quem automatiza.
A tabela
Seção intitulada “A tabela”| Código | O que significa | O que fazer |
|---|---|---|
| 401 | a chave não foi enviada, ou venceu | confira o cabeçalho Authorization; a chave dura um ano |
| 402 | o pedido está correto, falta crédito | é aviso para o financeiro, não defeito no seu código — não fique repetindo |
| 404 | o recurso não existe ou não é da sua conta | confira o identificador |
| 413 | a entrada passou do tamanho aceito | a mensagem traz o teto e o tamanho recebido |
| 422 | um parâmetro recebeu valor inválido | a resposta diz qual, em errors |
| 429 | requisições demais em pouco tempo | espere e repita |
| 503 | uma dependência nossa não respondeu | tente de novo — o pedido pode dar certo sem você mudar nada |
Três distinções que mudam o seu código
Seção intitulada “Três distinções que mudam o seu código”Erro de filtro não é silêncio
Seção intitulada “Erro de filtro não é silêncio”Valor inválido em filtro responde 422. channel=emial não devolve a lista de
e-mail como se o filtro tivesse funcionado.
É a diferença entre um erro que você vê na hora e uma conclusão errada que você leva meses para descobrir — “a minha conta não tem o que eu procuro”.
Quando a lista vem vazia e não é erro
Seção intitulada “Quando a lista vem vazia e não é erro”Resposta 200 com data vazio tem duas causas comuns, e nenhuma é falha:
- O registro ainda não foi arquivado. O arquivamento tem atraso; para saber no momento do evento, use o webhook.
- Saiu da janela de retenção. Cada mensagem é guardada pelo prazo configurado no domínio que a enviou, e depois sai do histórico. O prazo aparece no painel, em Domínios.
Se acontecer, não é você. A resposta é genérica de propósito: detalhe de exceção não sai para fora. Se persistir, fale com o suporte com o horário e o que você chamou.
