POST AI agent ready /v1/webhook/inbox/:id/list

Webhook ペイロードリスト API - 無料の受信トレイビューアー

Webhook 受信箱によってキャプチャされたすべてのペイロード (リクエスト本文、タイムスタンプ、一意のペイロード ID など) を取得します。最新のペイロードを最大 50 個返します。受信トレイは /v1/webhook/inbox/create エンドポイント経由で作成されている必要があります。

Endpoint

Code examples

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

When to use this API

Webhook プロバイダーが送信する正確なペイロード構造を検査する

テストイベントをトリガーした後、受信トレイのペイロードを一覧表示して、生の JSON 本文を確認します。これを使用して、スキーマを推測せずに Webhook ハンドラーの型付きインターフェイスを構築します。

Webhook フォワーダーがペイロードを正しく渡すことを確認します。

Webhook をプロキシまたはキュー経由でルーティングする場合は、プロキシ出力をテスト受信箱に向けます。リストされたペイロードを元のプロバイダーのペイロードと比較して、何も変更されていないことを確認します。

Webhook コンシューマー向けの自動統合テストを構築する

テストスイートで受信トレイを作成し、シミュレートされた Webhook ペイロードを送信してから、リストエンドポイントを呼び出してペイロードが到着したことをアサートします。模擬サーバーは必要ありません。

Frequently asked questions

受信トレイ ID が存在しないか期限切れの場合はどうなりますか?

API はコード INBOX_NOT_FOUND の 404 エラーを返します。受信トレイの有効期限が切れている場合は、新しい受信トレイを作成します。

ペイロードは時系列順に返されますか?

はい。ペイロードは、received_at タイムスタンプによって古いものから順に並べ替えられます。最新の 50 個のペイロードが含まれます。

受信トレイから個々のペイロードを削除できますか?

いいえ。ペイロードを個別に削除することはできません。 24 時間後に受信トレイとともに自動的に期限切れになります。

このエンドポイントは完全なペイロード本体を返しますか?

はい。受信トレイの受信 URL に送信された完全な JSON 本文は、各ペイロードエントリの本文フィールドに保存されて返されます。

受信トレイ ID は URL またはリクエスト本文で渡されますか?

受信トレイ ID は URL パス /v1/webhook/inbox/{id}/list で渡されます。リクエスト本文は空にすることもできます。

Get your API key

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