Estrutura de Erro
Todas as respostas de erro seguem o mesmo formato:Códigos HTTP
- 2xx Sucesso
- 4xx Erro do Cliente
- 5xx Erro do Servidor
Códigos de Erro
Autenticação
Validação
Sessões
Mensagens
Grupos
Contatos
Rate Limiting
Webhooks
Tratamento de Erros
Exemplo em TypeScript
Exemplo em Python
Boas Práticas
Sempre trate erros específicos
Sempre trate erros específicos
Não use apenas
catch genérico. Trate cada tipo de erro de forma adequada para melhor experiência do usuário.Implemente retry com backoff
Implemente retry com backoff
Para erros 5xx e 429, implemente retry automático com exponential backoff.
Log erros para debugging
Log erros para debugging
Salve logs detalhados de erros incluindo timestamp, path, e details para facilitar troubleshooting.
Monitore taxa de erros
Monitore taxa de erros
Configure alertas quando a taxa de erros 4xx ou 5xx ultrapassar um threshold.
Suporte
Se você encontrar um erro que não consegue resolver:Status Page
Verifique o status dos serviços
Suporte e atendimento: +55 87 8114-8453