Webhook 整合

定義

事件驅動的跨系統資料同步模式：當來源系統發生特定事件時，自動向目標系統發送 HTTP 請求，將事件資訊寫入或觸發後續動作。

關鍵數據點（附來源）

• GitHub Actions 監聽 push 事件後呼叫 Notion API，是典型的 Webhook 整合模式。（github-actions-notion-commit-log）
• 金流服務商的付款通知（callback/webhook）使用 [[請求簽章]] 驗證真實性。（api-security-design-connection-key）
• Webhook 接收端需驗證請求來源，GitHub、Stripe、LINE 等平台都用簽章機制。（api-security-design-connection-key）

前提與局限性

• Webhook 是推送模式，如果接收端暫時不可用，事件可能遺失（需重試機制）。
• 接收端暴露公開 URL，需要驗證請求來源的真實性。
• 高併發情境下可能需要佇列（queue）來緩衝。

衝突標記

（無）

關聯概念

• [[GitHub Actions]]
• [[請求簽章]]
• [[事件驅動架構]]
• [[DevOps 自動化]]