Programiści
Specyfikacja systemu dostarczania webhooków
Szablon specyfikacji, którego inżynierowie naprawdę używają — cele, antycele, SLO, tryby awarii
Zobacz podgląd danych wejściowych i wyjściowych
Dane wejściowe
- Feature
- outbound webhooks with retries and signed payloads
- Constraints
- at-least-once delivery, p95 < 5s, 100 RPS sustained
Wynik (fragment)
## Dostarczanie webhooków v1 — specyfikacja techniczna **Cel:** dostarczanie zdarzeń domenowych do endpointów klientów co najmniej raz, z ładunkami podpisanymi HMAC i ponowieniami z wykładniczym backoffem. **Antycele:** dokładnie raz, kolejność między typami zdarzeń. **Architektura:** szyna zdarzeń (NATS) -> pula workerów dostarczających (Go) -> endpointy HTTPS klientów. **Polityka ponowień:** 8 prób w ciągu 24 h z wykładniczym backoffem (1 s, 5 s, 30 s, 5 min, 30 min, 2 h, 6 h, 12 h). **Podpisywanie:** HMAC-SHA256 z treści, sekret rotowany per endpoint. **SLO:** dostarczenie p95 < 5 s, wskaźnik sukcesu > 99,5%. **Tryby awarii:** szczegółowa tabela obejmująca DNS, TLS, 5xx, 4xx, timeout, częściową odpowiedź, przekroczenie rozmiaru treści.
