Causas mais comuns
| Causa | Sinal típico |
|---|---|
| Credencial expirada ou revogada | Erros de autenticação (401, 403) |
| Versão da API descontinuada | Erros após uma data anunciada pelo fornecedor |
| Mudança no formato dos dados | Campos faltando ou com outro nome |
| Limite de requisições | Erros 429 em horários de maior uso |
| Certificado ou TLS | Falha de conexão segura após atualização do servidor |
| Serviço fora do ar | Erros 5xx ou tempo esgotado |
Como diagnosticar
- Verifique a página de status e os comunicados do fornecedor da API
- Leia os logs do sistema no momento das falhas: código e mensagem de resposta
- Confirme se as credenciais continuam válidas no painel do fornecedor
- Teste a chamada isoladamente, fora do sistema
Integrações mais robustas
- Registrar cada chamada e resposta (sem dados sensíveis)
- Tentar de novo automaticamente quando a falha é temporária
- Avisar alguém quando a falha persiste
- Acompanhar os avisos de mudança de versão dos fornecedores
- Guardar o que não foi enviado para reenviar depois
Leia também
Entenda o básico em como integrar sistemas com APIs. Se a integração é de pagamentos, veja pagamento aprovado, mas pedido não atualizado. Se envolve avisos recebidos, veja webhooks que não chegam ou chegam duas vezes.
Corrigimos integrações em sistemas existentes no nosso serviço de manutenção de sistemas PHP e Laravel.