Vývojáři
Specifikace systému doručování webhooků
Šablona specifikace, kterou inženýři opravdu používají — cíle, ne-cíle, SLO, režimy selhání
Zobrazit náhled vstupu a výstupu
Vstup
- Feature
- outbound webhooks with retries and signed payloads
- Constraints
- at-least-once delivery, p95 < 5s, 100 RPS sustained
Výstup (úryvek)
## Doručování webhooků v1 — technická specifikace **Cíl:** odchozí doručení doménových událostí na endpointy zákazníků alespoň jednou, s payloady podepsanými HMAC a opakováním s exponenciálním backoffem. **Ne-cíle:** doručení přesně jednou, řazení napříč typy událostí. **Architektura:** event bus (NATS) -> pool doručovacích workerů (Go) -> HTTPS endpointy zákazníků. **Politika opakování:** 8 pokusů během 24 h s exponenciálním backoffem (1 s, 5 s, 30 s, 5 m, 30 m, 2 h, 6 h, 12 h). **Podpis:** HMAC-SHA256 přes tělo, tajný klíč rotovaný pro každý endpoint. **SLO:** p95 doručení < 5 s, míra úspěšnosti > 99,5 %. **Režimy selhání:** podrobná tabulka pokrývající DNS, TLS, 5xx, 4xx, timeout, částečnou odpověď, překročení velikosti těla.
