Sviluppatori
Specifica per un sistema di consegna di webhook
Template di specifica che gli ingegneri usano davvero — obiettivi, non-obiettivi, SLO, modalità di errore
Mostra anteprima di input e output
Input
- Feature
- outbound webhooks with retries and signed payloads
- Constraints
- at-least-once delivery, p95 < 5s, 100 RPS sustained
Output (estratto)
## Consegna di webhook v1 — Specifica tecnica **Obiettivo:** consegna in uscita at-least-once degli eventi di dominio agli endpoint dei clienti con payload firmati in HMAC e ritentativi a backoff esponenziale. **Non-obiettivi:** exactly-once, ordinamento tra tipi di evento. **Architettura:** bus di eventi (NATS) -> pool di worker di consegna (Go) -> endpoint HTTPS dei clienti. **Policy di ritentativo:** 8 tentativi nell'arco di 24h con backoff esponenziale (1s, 5s, 30s, 5m, 30m, 2h, 6h, 12h). **Firma:** HMAC-SHA256 sul corpo, segreto ruotato per endpoint. **SLO:** consegna p95 < 5s, tasso di successo > 99,5%. **Modalità di errore:** tabella dettagliata che copre DNS, TLS, 5xx, 4xx, timeout, risposta parziale, sforamento della dimensione del corpo.
