Разработчики
Спецификация системы доставки вебхуков
Шаблон спецификации, которым инженеры действительно пользуются — цели, не-цели, SLO, сценарии отказа
Показать предпросмотр ввода и вывода
Ввод
- Feature
- outbound webhooks with retries and signed payloads
- Constraints
- at-least-once delivery, p95 < 5s, 100 RPS sustained
Вывод (фрагмент)
## Webhook Delivery v1 -- Tech Spec **Goal:** at-least-once outbound delivery of domain events to customer endpoints with HMAC-signed payloads and exponential-backoff retries. **Non-goals:** exactly-once, ordering across event types. **Architecture:** event bus (NATS) -> delivery worker pool (Go) -> customer HTTPS endpoints. **Retry policy:** 8 attempts over 24h with exponential backoff (1s, 5s, 30s, 5m, 30m, 2h, 6h, 12h). **Signing:** HMAC-SHA256 over body, secret rotated per endpoint. **SLOs:** p95 delivery < 5s, success rate > 99.5%. **Failure modes:** detailed table covering DNS, TLS, 5xx, 4xx, timeout, partial response, body-size overflow.
