ウェブフック配信システムの仕様
エンジニアが実際に使う仕様テンプレート — 目標、非目標、SLO、障害モード
入力と出力のプレビューを見る
入力
- Feature
- outbound webhooks with retries and signed payloads
- Constraints
- at-least-once delivery, p95 < 5s, 100 RPS sustained
出力(抜粋)
## ウェブフック配信v1 — 技術仕様 **目標:** HMAC署名付きのペイロードと指数バックオフによる再試行を備え、ドメインイベントを顧客のエンドポイントへ少なくとも1回(at-least-once)配信する。**非目標:** 厳密に1回(exactly-once)、イベント種別をまたぐ順序保証。**アーキテクチャ:** イベントバス(NATS) -> 配信ワーカープール(Go) -> 顧客のHTTPSエンドポイント。**再試行ポリシー:** 24時間で8回、指数バックオフ(1秒、5秒、30秒、5分、30分、2時間、6時間、12時間)。**署名:** ボディに対するHMAC-SHA256、シークレットはエンドポイントごとにローテーション。**SLO:** p95配信5秒未満、成功率99.5%超。**障害モード:** DNS、TLS、5xx、4xx、タイムアウト、部分レスポンス、ボディサイズ超過を網羅した詳細な表。