Webhook
網路鉤子（事件回呼）
01你是不是遇到這個 / THE SYMPTOM
我希望「別人那邊一發生某件事，我的系統就立刻知道」——例如有人付款成功、表單被填了、訂單狀態變了，我不想自己每隔幾秒去問一次「好了沒？好了沒？」
↑ 如果你點頭了，你要的關鍵字就是 Webhook。
02這是什麼 / DEFINITION
Webhook 是一種「反向 API」：不是你主動去問對方，而是事件發生時，對方主動打一個 HTTP 請求（通常是 POST）到你預先提供的網址，把資料推給你。
03什麼時候用 / WHEN TO USE
當你想即時收到第三方服務（金流、表單、GitHub、Stripe、LINE 等）的事件通知，而不想用輪詢（polling）一直去問。整合付款回調、CI/CD 觸發、聊天機器人收訊都是典型場景。
04怎麼跟 AI 說 / HOW TO ASK
直接複製這句、貼進 Claude Code / Cursor / Copilot / ChatGPT：
幫我寫一個接收 Stripe webhook 的 API 端點，驗證簽章後解析 payment_intent.succeeded 事件並更新訂單狀態
05常見坑 / WATCH OUT
⚠ 別跟「API 呼叫」搞反方向：API 是你打給別人，webhook 是別人打給你。兩個常見坑：(1) 一定要驗證簽章，否則任何人都能假造事件騙你的系統；(2) 對方可能重複送同一個事件，所以處理邏輯要做到冪等（idempotent），不然會重複出貨/重複加值。
06相關的詞 / RELATED