Pular para o conteúdo

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.

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

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”.

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.