配信ログとテスト
ウェブフック設定には送信先ごとの配信ログがあります。受信確認、失敗診断、実イベントなしの新しいサンプル送信に使えます。
配信ログを確認する
1
設定 → Webhookを開く
移動先：
Dashboard → Settings → Webhooks.2
Webhookの行を展開
次をクリックします： 配信ログ をWebhookカードで押します。最新50件の送信を新しい順に表示します。
3
各エントリーを確認
各行にイベントの種類、HTTPステータスコード、応答時間、タイムスタンプ、エラーメッセージがあればその内容が表示されます。
ログのフィールド
| フィールド | 説明 |
|---|---|
| イベント | 発生したイベントの種類（例： post.saved) |
| ステータス | エンドポイントが返したHTTPステータス。 null タイムアウトまたは接続拒否の場合。 |
| 応答時間 | 送信から応答の最後のバイトまでの往復時間（ミリ秒）。 |
| 成功 | 緑のチェック = HTTP 2xx。赤のバツ = その他の結果。 |
| エラー | 配信失敗時の、人が理解できるエラーメッセージ（例： Request timed out (10s)). |
| 配信日時 | 配信試行のUTC時刻。 |
テストイベントを送信する
1
Webhookカードを展開
内の
Settings → Webhooksで自分のwebhookを見つけ、次をクリックします： テストイベントを送信.2
配信ログを確認
数秒でテスト配信がDelivery Logsの先頭に表示されます。次を確認してください。
200 ステータスです。テストイベントも実際のHTTPリクエストです
テストも実際と同じ処理でHMAC署名を使うため、署名検証コード全体を試せます。
自動再試行なし
各配信は1回だけ試行されます。ログは診断用であり、失敗したライブイベントを再送するボタンはありません。エンドポイントを修正したら、「テスト」で修正を確認してください。
よくある失敗の原因
| エラー / ステータス | 考えられる原因 | 修正 |
|---|---|---|
Request timed out (10s) | サーバー応答に10秒以上かかった | 戻る 200 を即時返し、その後で非同期処理します |
401 | 署名検証に失敗 | JSON解析の前に生のボディを読み取ってください |
404 | エンドポイントURLのパスが存在しません | SavebaseのWebhook設定でURLを再確認してください |
500 | 受信側で未処理のエラー | サーバーログで例外を確認してください |
| 接続拒否 / ステータスnull | サーバー停止またはURL誤り | サーバー稼働と公開到達性を確認 |