Skip to main content

Tratamento de erros

A API usa códigos HTTP padrão. Todos os erros retornam JSON:

Códigos de erro

Exemplos de resposta

401 — API Key inválida

403 — Plano insuficiente

429 — Rate limit

O header Retry-After indica quantos segundos aguardar antes de tentar novamente.

Boas práticas

  • Sempre verifique o statusCode antes de processar a resposta
  • Implemente retry com backoff exponencial para erros 429 e 500
  • Registre o body completo do erro para facilitar debugging
  • Para 401, verifique se a API key não foi revogada em Configurações → Integrações

Exemplo de retry com backoff