Webhook は、イベントが起きたときに相手のサービスからこちらへ通知してもらう仕組みです。
たとえば決済完了、GitHub の push、フォーム送信のような出来事が起きたときに、相手側がこちらの URL へ HTTP リクエストを送って知らせてくれます。
まず押さえたいポイント
何か起きたら知らせてもらう仕組み- こちらから取りに行く API とは向きが違う
- 決済、GitHub、チャット通知、外部連携でよく使う
どんな場面で使うか
- 決済完了や失敗を受け取る
- push や Pull Request を受けて処理を動かす
- フォーム送信や会員登録を別システムへ通知する
- 社内ツール同士をイベント起点でつなぐ
どんなふうに理解するとよいか
初心者向けには、相手がベルを鳴らしてくれる仕組み と考えると分かりやすいです。
こちらが何度も見に行かなくても、イベントが起きた瞬間に通知してもらえるのが便利なところです。
押さえておきたい注意点
Webhook は、URL を1本作って受けるだけでは終わりません。
本当に正しい送り主かを確かめる 署名検証、再送されても壊れないようにする 冪等性、重い処理をすぐ返さない設計まで見た方が安全です。