Webhookの意味

Webhookは、あるサービスでイベントが発生したときに、あらかじめ登録した外部サーバーへHTTPリクエストを送るイベント駆動型の連携方式です。GitHub公式ドキュメントでは、リポジトリへのpushやプルリクエストなどのイベントを契機に、指定URLへデータを配信する仕組みとして説明されています。受信側はリクエストの署名や送信元、イベント種別、再送を検証して処理し、重複配信に耐える設計にします。WebhookはAPIを一定間隔で呼び出すポーリングより無駄な通信を減らしやすく、CI実行、チャット通知、チケット登録、デプロイ開始などに使われます。一方、受信エンドポイントの公開、認証情報、タイムアウト、再試行、順序逆転、ペイロード上限、障害時の再処理を考える必要があります。Webhookは通知を受け取る方式であり、処理結果を返す業務APIやイベントの永続基盤そのものではありません。読み方は「ウェブフック」です。

Webhookが使われる背景には、サービス内のイベントを契機に外部システムへ通知し、定期的なポーリングなしで連携したい需要があります。GitHub資料が示すpushやプルリクエストの通知を具体例として扱います。

Webhookはイベント発生時に外部へデータを届ける仕組みなので、ポーリングや一般的なAPI呼び出しとは区別します。