Ontwikkelaars
Specificatie voor een webhook-bezorgsysteem
Specificatietemplate die engineers echt gebruiken -- doelen, niet-doelen, SLO's, faalmodi
Voorbeeld van invoer en uitvoer bekijken
Invoer
- Feature
- outbound webhooks with retries and signed payloads
- Constraints
- at-least-once delivery, p95 < 5s, 100 RPS sustained
Uitvoer (fragment)
## Webhook Delivery v1 -- Technische specificatie **Doel:** at-least-once uitgaande bezorging van domeingebeurtenissen naar klantendpoints met HMAC-ondertekende payloads en exponential-backoff-retries. **Niet-doelen:** exactly-once, ordening tussen eventtypen. **Architectuur:** event bus (NATS) -> delivery-workerpool (Go) -> HTTPS-endpoints van klanten. **Retry-beleid:** 8 pogingen over 24u met exponential backoff (1s, 5s, 30s, 5m, 30m, 2h, 6h, 12h). **Ondertekening:** HMAC-SHA256 over de body, geheim per endpoint geroteerd. **SLO's:** p95-bezorging < 5s, succespercentage > 99,5%. **Faalmodi:** gedetailleerde tabel die DNS, TLS, 5xx, 4xx, time-out, gedeeltelijke respons en body-size-overflow dekt.
