POST AI agent ready /v1/webhook/inbox/create

Webhook Inbox API - 無料の一時エンドポイント

受信 URL を使用して一意の Webhook 受信ボックスを作成します。受信ボックス URL に送信された POST リクエストは 24 時間保存されます。リストエンドポイントを使用して、キャプチャされたすべてのペイロードを取得します。サーバーを展開せずにサードパーティの Webhook 統合をテストする場合に役立ちます。

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/webhook/inbox/create \
  -H "Content-Type: application/json" \
  -d '{}'

When to use this API

サーバーをデプロイせずに Stripe または GitHub Webhook ペイロードをテストする

受信トレイを作成し、URL を Stripe の Webhook 設定に貼り付け、テストイベントをトリガーします。ハンドラーコードを作成する前に、キャプチャされたペイロードを取得して構造を確認します。

本番環境で失敗した Webhook 統合をデバッグする

失敗した Webhook を一時的な受信トレイにポイントし、プロバイダーが送信する正確なペイロードをキャプチャします。パーサーの期待値と比較して、不一致を見つけます。

Frequently asked questions

Webhook 受信ボックスはどれくらいの期間存続しますか?

各受信トレイとそのキャプチャされたペイロードは 24 時間後に期限切れになります。このウィンドウを拡張する方法はありません。 For persistent storage, forward payloads to your own server.

1 つの受信箱でキャプチャできるペイロードの数は何ですか?

受信箱には、最新のペイロードが最大 50 個保存されます。さらに到着すると、最も古いものが削除されます。大規模なテストの場合は、複数の受信トレイを作成します。

受信トレイ URL に GET リクエストを送信できますか?

いいえ。受信トレイ受信 URL は POST リクエストのみを受け入れます。 GET リクエストは 404 を返します。これは、ほとんどの Webhook プロバイダーの動作と一致します。

受信トレイの URL は一般公開されていますか?

はい。受信トレイ URL を知っている人は誰でも、それにペイロードを送信できます。受信ボックス ID は 8 文字のランダムな 16 進文字列であるため、推測することが困難です。機密の本番データをテスト受信箱に送信しないでください。

受信トレイを作成するには API キーが必要ですか?

エンドポイントは、1 分あたり 5 リクエストの匿名アクセスで動作します (IP ベースのレート制限)。 API キーによりレート制限が解除されます。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.