Développeurs
Spécification d'un système de livraison de webhooks
Modèle de spécification que les ingénieurs utilisent vraiment — objectifs, non-objectifs, SLO, modes de défaillance
Voir l’aperçu de l’entrée et de la sortie
Entrée
- Feature
- outbound webhooks with retries and signed payloads
- Constraints
- at-least-once delivery, p95 < 5s, 100 RPS sustained
Sortie (extrait)
## Livraison de webhooks v1 — Spécification technique **Objectif :** livraison sortante « au moins une fois » des événements de domaine vers les endpoints clients, avec des charges utiles signées HMAC et des retentatives à backoff exponentiel. **Non-objectifs :** « exactement une fois », ordre entre types d'événements. **Architecture :** bus d'événements (NATS) -> pool de workers de livraison (Go) -> endpoints HTTPS clients. **Politique de retry :** 8 tentatives sur 24 h avec backoff exponentiel (1 s, 5 s, 30 s, 5 m, 30 m, 2 h, 6 h, 12 h). **Signature :** HMAC-SHA256 sur le corps, secret rotaté par endpoint. **SLO :** livraison p95 < 5 s, taux de succès > 99,5 %. **Modes de défaillance :** tableau détaillé couvrant DNS, TLS, 5xx, 4xx, timeout, réponse partielle, dépassement de la taille du corps.
