डेवलपर
एक webhook डिलीवरी सिस्टम के लिए स्पेक
ऐसा स्पेक टेम्पलेट जिसे इंजीनियर वास्तव में इस्तेमाल करते हैं -- goals, non-goals, SLOs, फेल्योर मोड
इनपुट और आउटपुट का पूर्वावलोकन देखें
इनपुट
- 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.
