WebhookはHTTP POSTを受け取るだけでは安定運用できません。実際には、生データの署名検証、古いイベントの拒否、同一イベントの重複防止、処理失敗時の再試行、最終失敗の隔離、安全な再実行、監査履歴が必要です。 本商品は、基本サンプルでは省略されがちな失敗経路を含むPythonリファレンス実装です。StripeとGitHubの署名アダプター例を含み、プロバイダー検証と業務処理を分けて差し替えられます。 【主な内容】 ・受信時の生リクエスト本文を保持するWebhookエンドポイント ・Stripe／GitHub署名検証アダプター ・タイムスタンプ・再送窓検証 ・シークレット切替を考慮した構造 ・冪等な受信、重複配送、ID衝突の検出 ・リース付き処理、状態遷移、指数バックオフ再試行 ・最終失敗用デッドレターキュー ・終端状態からのガード付き同一ペイロード再実行 ・機密項目マスキングと監査履歴 ・SQLite、CLI、決定的フィクスチャ、失敗注入テスト、Docker／Compose 【実動作画像（2〜6枚目）】 同梱の合成データと販売ZIPのコードによる実行結果から、項目を抜粋して再構成しました。顧客データや実サービスの鍵は使用していません。 2. 合成Stripeペイロードを署名検証して受信を記録。 3. 同じ配送を再送し、イベントを増やさず受信履歴を追加。 4. ローカルのデモ処理を実行し、状態と試行回数を確認。 5. 終端イベントを同一ペイロードで再実行し、世代と履歴を確認。 6. 販売ZIPで自動テスト28件が成功。外部サービスへの送信は行っていません。 【対象者】 PythonサービスへStripe、GitHub、独自Webhookを追加する開発者、Webhook信頼性基盤を毎回作り直したくないSaaSチーム、監査可能なイベント処理が必要な社内ツール・受託開発者。 【含まれないもの】 ホスティング、TLS終端、デプロイ、マネージドWebhookサービス、マルチテナントSaaS、課金機能、管理画面、個別プロバイダー対応、業務ロジック、リモート側処理の完全なExactly-once保証は含みません。 【動作要件】 Python 3.9以上、仮想環境、SQLiteを利用できるローカルファイルシステム。Docker／Docker Composeは任意です。 【ライセンス】 1個人または1法人が、商用利用、改変、複数の社内プロジェクト、許可された顧客成果物への組み込みを行えます。本商品の再販売、再配布、公開リポジトリへの掲載、実質的に同等なテンプレートとしての再包装は禁止です。同梱ライセンス全文が優先されます。 【サポート】 README／Quickstart範囲のセットアップ質問と再現可能な商品不具合が対象です。個別開発、カスタムアダプター、デプロイ、運用代行、SLA、回答時間保証、無期限更新は含みません。 【返金】 デジタル商品の性質上、ダウンロード後は原則返金不可です。ただし、重複購入、破損または利用不能なダウンロード、公開された商品説明との重大な相違、または適用法令上必要な場合は対応します。