01
送信準備ができてから作成
30分の期限は最初のイベントではなくURLの作成時に始まります。管理キーはこのタブのメモリーだけに置かれるため、再読み込みすると以前の記録を開けなくなります。
HTTP・リクエストの調査
Webhookテスト届いた内容をそのまま調べる
一時受信URLを作り、送信元からテスト通知を送って実際の内容を確認します。
Webhookテスト
受信イベント
受信URL
まだリクエストがありません。
Webhookの送信元またはHTTPクライアントからテスト通知を送ってください。URLを知る人は送信できますが、閲覧キーはこのタブだけにあります。
まだリクエストがありません。
リクエストの詳細
イベントを選ぶとヘッダーと本文を確認できます。
リクエストはHeyUtilsのサーバーで受信し、30分後に削除します。一般的な機密ヘッダーは保存前に伏せますが、パス、クエリ、本文は伏せません。テストデータだけを送ってください。
受信済みイベントを絞り込む
受信箱を作成するとURLが表示されます。
決済サービスが送信済みと表示しているのに自分の処理に記録がないとき、Webhookテスト用の独立した受信先が役立ちます。Webhook受信URLを送信元のテスト設定に登録し、届いた方法、パス、クエリ、ヘッダー、本文を期待値と照合できます。
このWebhookテスターは本番用のエンドポイントではありません。公開URLは受信用で、イベント閲覧にはこのタブだけが持つ管理キーが必要です。リクエスト確認を先に済ませれば、自分の処理系に原因があるかを切り分けられます。
Webhookテストで実際の通知を確認する理由
送信用の公開URLと閲覧用の管理キーを分けます。
送信者に閲覧権限を渡さない
送信側に必要なのは一時URLだけです。Webhookテストでは別の管理キーがない限りイベント一覧を開けません。一般的な認証ヘッダーは保存前に伏せますが、Webhookペイロードの本文とURLのパラメーターはそのまま残ります。
外部へ転送しない複製
選んだイベントを確認後、同じ受信箱に複製して再試行の記録を比べられます。任意の宛先へHTTPリクエストを送る仕組みではないため、自分のアプリの再処理や本番への再送を試す機能とは異なります。
30分の受信期間を無駄にしない手順
02
まず方法とパスを見る
タブが表示されている間は3秒ごとに一覧が更新されます。続いてクエリ、伏せたヘッダー、本文を確認してください。UTF-8として読めない本文はBase64表示になります。
03
現在の絞り込みで保存
方法と文字列の絞り込みは既に受信したイベントだけに適用され、受信条件は変わりません。変更直後は結果が古いため保存を止め、更新後の表示分だけをJSONに出します。
実際のHTTP通知から分かること
受信したHTTPを記録
WebhookテストのURLはGET、POST、PUT、PATCH、DELETE、HEAD、OPTIONSを受け付けます。時刻、方法、パス、クエリ、伏せたヘッダー、最大64KiBの本文を記録し、上限超過の本文を途中まで保存することはありません。
再試行の中から探す
メソッドで絞るか、パスと本文の文字列を検索できます。詳細のコピーとJSONの保存は現在見えている記録に基づき、管理キーは出力に含まれません。
期限と容量を固定
ランダムな受信URLは30分だけ有効で、50件まで記録します。サーバーの期限処理がデータを消去し、タブが非表示になると定期取得を止めます。急ぎの確認には手動更新を使えます。
テストデータを送る前の境界
- ブラウザー内だけの処理ではない
- 送信元がURLを呼ぶとデータはHeyUtilsのサーバーに届きます。本番の秘密情報や顧客情報は送らないでください。AuthorizationやCookieなどは保存前に伏せますが、パス、クエリ、独自項目、本文は自動的に伏せられません。
- 複製は自分の受信箱内だけ
- 複製は同じ受信箱に一件追加し、50件の枠を使います。外部サーバーへの転送、localhostへのトンネル、HMAC署名の検証、応答コードの変更は行いません。必要な検証は自分の環境で実施してください。
- 期限と上限は受信前に適用
- 新しいイベントが来ても30分の期限は延びません。本文64KiB、ヘッダー8KiBを超える場合や、受信箱が満杯・短時間の連続送信の場合は不完全な記録を残さず拒否します。恒久履歴や共有ページはありません。
Webhookテストのよくある質問
Webhookの署名を検証するにはどうすればよいですか？
この受信箱は署名を検証しません。プロバイダーごとに生の本文と署名方式が異なるため、提供元の仕様に従って自分の環境で確認し、本番用の秘密キーは一時サービスに送らないでください。
このツールで私のWebhookデータは安全ですか？
受信URLを知る人は送信できますが、イベントの閲覧にはこのタブの別の管理キーが必要です。一般的な機密ヘッダーは保存前に伏せますが、パス、クエリ、本文は残るのでテストデータだけを使ってください。
このツールはどのWebhookプロバイダーをサポートしていますか？
特定のプロバイダー専用ではありません。公開HTTPSのWebhook受信URLへHTTPリクエストを送れるサービスなら到着内容を確認できますが、サービス固有の署名が正しいことは判定しません。
このツールからテスト用のWebhookリクエストを送信できますか？
このページは自動でテスト通知を送信しません。送信元のテスト機能や自分のHTTPクライアントから受信URLへ小さなリクエストを送ってください。受信箱内の複製は外部へ送信しません。
Webhookテストに公開URLは必要ですか？
送信元が通知できる公開URLが必要です。このツールは30分有効なURLを作ります。ローカルのサーバーを直接公開したり、トンネルでlocalhostへ転送したりする機能はありません。
通知の内容が予想と違いましたか？
Webhookテストで通知を一件受け取る
送信側を準備してから受信箱を作り、30分以内に届いたイベントを確かめましょう。
リクエストはHeyUtilsのサーバーに一時保存され、期限後に削除されます。