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
Retry-After indica quantos segundos aguardar antes de tentar novamente.
Boas práticas
- Sempre verifique o
statusCodeantes de processar a resposta - Implemente retry com backoff exponencial para erros
429e500 - 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