概要
はてなブックマークの公開ブックマークに変更があった際、登録されたURLにHTTP POSTリクエストでペイロードを送信します。
HTTPリクエスト仕様
| メソッド | POST |
|---|
| Content-Type | application/json |
|---|
| User-Agent | HatebuWebhook/1.0 |
|---|
ペイロード構造
| フィールド | 型 | 説明 |
|---|
event | string | イベント種別 |
timestamp | string | ISO 8601形式の検知日時 |
webhook.id | string | Webhook ID |
webhook.name | string | Webhook名 |
bookmark.url | string | ブックマークしたURL |
bookmark.title | string | ページタイトル |
bookmark.comment | string | コメント |
bookmark.tags | string[] | タグ一覧 |
bookmark.bookmarked_at | string | ブックマーク日時 |
user.hatena_id | string | はてなID |
サンプル
{
"event": "new",
"timestamp": "2024-01-15T12:34:56.789Z",
"webhook": {
"id": "abc123",
"name": "My Webhook"
},
"bookmark": {
"url": "https://example.com/article",
"title": "記事タイトル",
"comment": "コメント内容",
"tags": ["tech", "programming"],
"bookmarked_at": "2024-01-15T12:30:00.000Z"
},
"user": {
"hatena_id": "username"
}
}イベントタイプ
| イベント | 説明 |
|---|
new | 新規ブックマークが追加された |
tag_changed | 既存ブックマークのタグが変更された |
comment_changed | 既存ブックマークのコメントが変更された |
タグフィルター
Webhook作成時にタグフィルターを設定すると、特定のタグが含まれるブックマークのみ通知できます。
| モード | 動作 |
|---|
none | フィルターなし（すべて通知） |
and | 指定したタグがすべて含まれる場合に通知 |
or | 指定したタグのいずれかが含まれる場合に通知 |
検知仕様
- 最新100件のブックマークを1時間ごとにチェックします
- 過去の記録と比較して、新規追加、タグ変更、コメント変更を検知します
- 101件目以降の古いブックマークの変更は検知されません
- ブックマークの削除は検知されません
