Webhook
ウェブフック
ウェブフックは、イベントが起きた時に送られるHTTPの通知です。別のシステムに反応するよう伝えます。
もう一つの例
支払いサービスが、署名された payment.succeeded イベントを注文サービスに送るよ。
主な部分
- 01Originating request
- 02Resolution or processing hop
- 03Response, timing, and failure
以下の場合に使用します
各ペイロードに署名します。処理を冪等にし、送信失敗を再試行し、耐久性のあるイベント記録を保持します。
以下の場合は使用しないでください
イベントが順番通りに、または一度だけ到着すると決して仮定しないこと。確認していない送信者を決して信用しないこと。
コードで使用する名前
POST callback + signature 出荷前に
Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback.
Outcome:Complete the task with ウェブフック (Webhook)。 User context:支払いサービスが、署名された payment.succeeded イベントを注文サービスに送るよ。 Technical concept or control:ウェブフック (Webhook)。 Why it fits:各ペイロードに署名します。処理を冪等にし、送信失敗を再試行し、耐久性のあるイベント記録を保持します。 Do not use it when:イベントが順番通りに、または一度だけ到着すると決して仮定しないこと。確認していない送信者を決して信用しないこと。 Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary):単一の公式標準が全体の用語を管理するわけではありません。その意味はチーム、プラットフォーム、またはフレームワークによって変わる可能性があります。 Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.
このリクエストを確認する
Review how ウェブフック (Webhook) is used now. Definition: ウェブフックは、イベントが起きた時に送られるHTTPの通知です。別のシステムに反応するよう伝えます。 Release checks: Check contracts and invariants, authorization, and input limits. Test retries, one-time effects, timeouts, and partial failures. Verify data integrity, compatibility, monitoring, recovery, and rollback. Before changing code, list the evidence, gaps, severity, and the smallest safe fix.