はてなブックマーク Web Hook

はてなブックマークでのイベント発生時に、通知を受け取ることができるサービスです。

はてなブックマークへの登録

イベント発生時に通知を受け取れるように、はてなブックマークへ登録します。

はてなブックマークの[設定]ページを開きます。そして[外部サイト連携]のタブを選択し、[Web Hook]の項目で[イベント通知を受けとるURL]などを設定します。

このとき、受け取るイベントの種類も設定できます。

イベントの種類

以下のいずれかに該当するとき、指定URLへのリクエストが発生します。

  • 自分がブックマークを追加、更新、削除したとき
  • 自分のブックマークに、第三者から「はてなスター」が付与されたとき
  • 自分に対して、第三者からはてなブックマークのコメントで「IDコール」が送信されたとき
  • 自分がお気に入りに入れている公開設定のユーザーが、新規に公開設定でブックマークしたとき

通知の取得

リクエストされたページにおいてPHPで、

var_dump( $_POST );

とすると、POSTされる値は以下のようなものであることが確認できます。

array(12) {
  ["is_private"]=> string(1)  "0"
  ["count"]=>      string(3)  "700"
  ["uid"]=>        string(8)  "12345678"
  ["status"]=>     string(3)  "add"
  ["key"]=>        string(3)  "foo"
  ["username"]=>   string(4)  "BABA"
  ["permalink"]=>  string(53) "http://b.hatena.ne.jp/BABA/20101001#bookmark-99999999"
  ["client"]=>     string(3)  "Web"
  ["timestamp"]=>  string(25) "2010-10-01T00:00:00+09:00"
  ["comment"]=>    string(4)  "TEST"
  ["url"]=>        string(25) "https://www.google.co.jp/"
  ["title"]=>      string(6)  "Google"
}