Webhook

📖 もうちょい詳しく

何が新しいの？

Webhookは、何かのできごと（イベント）が起きた瞬間に、別のサービスへ自動でお知らせを送るしくみです。
ふつうのAPIは「使う側が必要なときに聞きに行く」かたちでした。Webhookはその逆で、「変化が起きたら、相手のほうから知らせてくれる」のが特徴です。「Web」＋「Hook（引っかける・フックする）」という名前のとおり、できごとに反応してお知らせが引っかかるイメージです。

どうやって動いてるの？

まず、お知らせを受け取りたい側が、自分の受け取り口となるURLを相手に登録しておきます。
そして対象のできごとが起きると、送る側はそのURLに向けて、内容をまとめたデータ（多くはJSONという軽い形式）を HTTP で送り込みます。受け取った側はその中身を見て、メール送信や記録など、決めておいた処理をその場で動かします。

何ができるの？

「起きたらすぐ動く」自動化を、待ち時間なしで組めます。
たとえば、ネットショップで注文が入ったら通知を飛ばす、コードが更新されたら自動でテストを始める、フォームが送信されたらチャットに知らせる、といった連携です。何度も「まだ？まだ？」と確認しに行かずに済むので、むだな通信が減り、反応も早くなります。

🌱 身近なたとえ

宅配便の不在通知で例えると、Webhookは「荷物が届いたその場で届くお知らせ」です。
あなたが郵便局に何度も電話して「私あての荷物、来ましたか？」と聞き続ける必要はありません。荷物が到着した瞬間に、向こうからスマホへ通知が飛んできます。
あらかじめ「ここに連絡してね」と連絡先を伝えてあるからこそ、できごとが起きた瞬間に向こうから知らせが来る、という関係です。

✅ まず覚えるポイント

• Webhookは「できごとが起きたら相手から自動でお知らせが来る」しくみ
• ふつうのAPIは聞きに行く側、Webhookは知らせてくれる側
• 受け取り口となるURLを、あらかじめ登録しておく
• お知らせはHTTPで送られ、中身はJSONなどのデータ
• 「起きたらすぐ動く」自動化づくりに向いている

🧭 よくある勘違い

WebhookとAPIは別物なの？

まったくの別物ではありません。Webhookは、APIの一つの使い方・形だと考えると整理しやすいです。
ふつうのAPIが「こちらから聞きに行く」向きなら、Webhookは「向こうから知らせてくれる」向き、という違いです。どちらもHTTPでデータをやり取りする仲間です。

受け取り口のURLは誰でもアクセスできて危なくない？

たしかに、受け取り口は外から届く入口なので、注意が必要です。
そのため、本当に正しい相手からのお知らせかを確認する合言葉（署名やトークン）を付けることが多いです。これで、知らない相手からの偽のお知らせを見分けやすくなります。

🧩 関連して覚えると楽な言葉

• API: アプリ同士の窓口。Webhookはその「向こうから知らせる」使い方
• HTTP: Webのやり取りのルール。お知らせを送るときに使われる
• cron: 決まった時刻に動く自動化。Webhookは「できごと起点」で動く点が対照的
• サーバー: お知らせを受け取って処理する側になることが多い

🏁 ひとことでまとめ

Webhookは、できごとが起きた瞬間に相手のほうからお知らせを届けてくれるしくみです。
こちらが何度も確認しに行かなくても、変化に合わせて自動で次の処理が動く——サービス同士をなめらかにつなぐ、便利な合図のような存在です。