- 無料
- 登録不要
- 24時間で期限切れ
Webhook / コールバックテスター
一時URLを取得し、コールバックをそこに向けて、受信したボディと保持されたヘッダーを検査します。HiAPI非同期タスクのコールバックデバッグ用に構築されています。64 KiBを超えるPOSTボディは413を返し、保存も切り詰めもされません。Cookie、転送/クライアントIP、イングレスシークレットヘッダーは保持されません。
このURLを持っている人は誰でもここに届く内容を読むことができ、期限切れ時にすべて削除されます。本番トラフィックや機密データには使用しないでください。
このブラウザからサンプルペイロードをアドレスに送信し、実際のコールバックを設定する前にツールの動作を確認できます。
送信者が受け取る応答
これを変更して再試行をテストします：非2xxステータスを返すと、HiAPIがコールバックを再試行し、リストでスケジュールを確認できます。
リクエスト
最初のリクエストを待っています…
上記のURLにコールバックを向けるか、テストリクエストを送信して見え方を確認してください。
リクエスト詳細
リクエストを選択してヘッダーとボディを表示します。
このコールバックでタスクを作成
これをコピーし、キーとモデルを置き換えて実行してください。
curl -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1.0",
"callback": { "url": "https://www.hiapi.ai/tools/webhook-tester/hook/YOUR_TOKEN", "when": "final" },
"input": { "prompt": "a cyan glass data center entrance", "duration": 5, "resolution": "720p" }
}'How to test a webhook in three steps
一時URLをコピー
このページを開き、表示されるアドレスをコピーします。24時間有効で、任意の送信元からのPOSTを受け付けます。
コールバックをそこに向ける
非同期タスクを作成する際にcallback.urlとして渡すか、「テストリクエストを送信」ボタンで即座に送信します。
リクエストを読む
リクエストは到着次第表示されます。ヘッダー、ボディ、コンテンツタイプを検査し、Webhook署名キーを貼り付けて署名をローカルで確認します。
What this tool cannot do
- HiAPI HMACの一貫性のみを比較し、新鮮さやリプレイ防止は検証しません。一致するだけでは送信元を証明できません。署名キーがない場合、コールバックは他のPOSTと同じです。
- 64 KiBを超えるボディは413を返し、保存も切り詰めもされません。Cookie、転送/クライアントIP、イングレスシークレットヘッダーは保持されません。
- リプレイは正確な元のリクエストではありません。ヘッダーは削除され、CORS、混合コンテンツ、ローカルネットワークのルールがブロックする可能性があります。localhostへのアクセスは保証されません。
- タスクを検索できません。ペイロードのみを受信するため、タスクの状態、残高、成果物にはアクセスできません。
- 永続的なストレージではありません。アドレスとその内容は24時間後に破棄されます。本番データや機密データを送信しないでください。
- URLは認証情報です。URLを持っている人は誰でも到着した内容を読むことができます。
- HiAPIはパブリックインターネット経由で到達する必要があるため、localhostターゲットが実際のHiAPIコールバックを受信することはありません。
Webhook tester FAQ
Webhookテスターの目的は？
Webhookテスターは、受信HTTPリクエストを受け付け、保持されたヘッダーとボディを表示するアドレスを提供します。Cookie、転送/クライアントIP、イングレスシークレットヘッダーは破棄されます。64 KiBを超えるボディは413を返し、保存も切り詰めもされません。コールバックを検査するためだけにサーバーを立てる手間を省きます。
HiAPIコールバックをテストするには？
HiAPI APIでタスクを作成し、このページのURLをcallback.urlとして渡します。タスクが終端状態に達すると、HiAPIが結果をここにPOSTし、リクエストがリストに表示されます。
ローカルでHiAPIに対してテストするとコールバックが届かないのはなぜですか？
コールバックはパブリックインターネットから到達可能である必要があります。お客様のマシンは通常そうではないため、localhostアドレスが実際のHiAPIコールバックを受信することは決してありません。パブリックホストのURLを使用してください。このページが提供します。
コールバックが本当にHiAPIからのものかを検証できますか？
Webhook署名キーを使用すると、このツールは保持されたボディとX-HiAPI-TimestampでHMAC-SHA256を再計算し、X-HiAPI-Signatureをローカルで比較します。一致はそのキーとの一貫性を示し、新鮮さやリプレイ防止を示すものではありません。署名キーがない場合、比較する署名はありません。
Webhook署名キーはサーバーに送信されますか？
いいえ。キーはブラウザのCrypto API内でのみ署名の再計算に使用されます。送信、保存、ログ記録は一切されず、サーバーに届くリクエストにも含まれません。
アドレスの有効期間とデータの処理は？
アドレスと受信したすべての内容は24時間後に削除されます。各アドレスは最大50件のリクエストを保持します。URLを認証情報として扱ってください。URLを持っている人は誰でも到着した内容を読めるため、本番や機密データには使用しないでください。
失敗したコールバックの再試行頻度はわかりますか？
はい、そのために応答ステータスが設定可能になっています。応答を400または500に設定し、実際のタスクをトリガーすると、リストの到着時刻が再試行スケジュールを示します。再試行は即時、その後+1分、+5分、+20分で、合計4回です。
リクエストをリプレイできますか？
リプレイはブラウザからのベストエフォートのリクエストであり、正確なコピーではありません。Cookie、認証、プロキシ/プラットフォーム、ブラウザ制御のヘッダーは転送されず、リダイレクトは拒否されます。ターゲットはCORSを許可する必要があります。HTTPSからHTTPへの混合コンテンツやブラウザのローカルネットワークルールがブロックすることがあります。localhostは動作する場合がありますが保証されません。ブロックされた応答は、ターゲットが何も受信しなかったことを証明しません。