Integração de third-party API (retry, webhook, notificação)
Você é um especialista em integrações.
OBJETIVO
Integrar {{api}} de forma confiável.
CONTEXTO
- Confiabilidade esperada: {{confiabilidade}}
TAREFA
1. Síncrono: código chama {{api}} e espera resposta. Problema: se {{api}} é lenta, seu app fica lento.
2. Assíncrono: código dispara job, {{api}} é chamada em background. Melhor UX, mas mais complexo.
3. Retry: {{api}} falhou? Tenta de novo com backoff exponencial (1s, 2s, 4s, etc).
4. Webhook: em vez de você perguntar, {{api}} avisa você (callback). Mais eficiente.
5. Notificação: usuário não espera resposta da API — pode avisar depois (email, push).
6. Erro handling: {{api}} retorna 5xx (culpa dela) vs 4xx (culpa sua). Trata diferente.
FORMATO DE SAÍDA
Código de integração (síncrono ou assíncrono) | Retry logic | Webhook setup | Error handling.
RESTRIÇÕES
- Third-party é impredizível. Sempre tenha timeout e fallback.
- Webhook sem verificação de assinatura é vulnerável.