Programadores
Especificação para um sistema de entrega de webhooks
Modelo de especificação que os engenheiros realmente usam — objetivos, não-objetivos, SLOs, modos de falha
Ver pré-visualização de entrada e saída
Entrada
- Feature
- outbound webhooks with retries and signed payloads
- Constraints
- at-least-once delivery, p95 < 5s, 100 RPS sustained
Saída (excerto)
## Entrega de Webhooks v1 — Especificação Técnica **Objetivo:** entrega externa pelo menos uma vez de eventos de domínio para os endpoints dos clientes, com payloads assinados por HMAC e repetições com backoff exponencial. **Não-objetivos:** entrega exatamente uma vez, ordenação entre tipos de evento. **Arquitetura:** barramento de eventos (NATS) -> pool de workers de entrega (Go) -> endpoints HTTPS dos clientes. **Política de repetição:** 8 tentativas ao longo de 24h com backoff exponencial (1s, 5s, 30s, 5m, 30m, 2h, 6h, 12h). **Assinatura:** HMAC-SHA256 sobre o corpo, segredo rotacionado por endpoint. **SLOs:** entrega p95 < 5s, taxa de sucesso > 99,5%. **Modos de falha:** tabela detalhada que cobre DNS, TLS, 5xx, 4xx, timeout, resposta parcial, excesso de tamanho do corpo.
