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

Webhook 有效负载列表 API - 免费收件箱查看器

检索 Webhook 收件箱捕获的每个有效负载，包括请求正文、时间戳和唯一的有效负载 ID。返回最多 50 个最新负载。收件箱必须是通过 /v1/webhook/inbox/create 端点创建的。

Endpoint

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

触发测试事件后，列出收件箱有效负载以查看原始 JSON 正文。使用它为您的 webhook 处理程序构建类型化接口，而无需猜测架构。

如果您通过代理或队列路由 Webhook，请将代理输出指向测试收件箱。将列出的有效负载与原始提供程序有效负载进行比较，以确认没有任何更改。

在测试套件中创建一个收件箱，发送模拟的 Webhook 负载，然后调用列表端点来断言负载已到达。不需要模拟服务器。

如果收件箱 ID 不存在或已过期，会发生什么情况？

API 返回 404 错误，代码为 INBOX_NOT_FOUND。如果您的收件箱已过期，请创建一个新的收件箱。

有效负载是否按时间顺序返回？

是的。有效负载按 receive_at 时间戳排序，最旧的在前。包括最近 50 个有效负载。

我可以从收件箱中删除单个有效负载吗？

不可以。有效负载不能单独删除。 24 小时后，它们会随收件箱自动过期。

该端点是否返回完整的有效负载主体？

是的。发送到收件箱接收 URL 的完整 JSON 正文存储在每个负载条目的正文字段中并返回。

收件箱 ID 是通过 URL 还是请求正文传递的？

收件箱 ID 在 URL 路径中传递：/v1/webhook/inbox/{id}/list。请求正文可以为空。

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