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

Webhook Inbox API - 免费临时端点

创建带有接收 URL 的唯一 Webhook 收件箱。发送到收件箱 URL 的任何 POST 请求都会存储 24 小时。使用列表端点检索所有捕获的有效负载。对于在不部署服务器的情况下测试第三方 Webhook 集成非常有用。

Endpoint

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

When to use this API

创建收件箱，将 URL 粘贴到 Stripe 的 webhook 设置中，然后触发测试事件。在编写处理程序代码之前检索捕获的有效负载以验证结构。

将失败的 Webhook 指向临时收件箱，以捕获提供商发送的确切负载。将其与您的解析器期望进行比较以找到不匹配的地方。

Webhook 收件箱可以持续多长时间？

每个收件箱及其捕获的有效负载将在 24 小时后过期。没有办法延长这个窗口。对于持久存储，请将有效负载转发到您自己的服务器。

一个收件箱可以捕获多少个有效负载？

收件箱最多可存储 50 个最新负载。如果有更多的人到达，最老的人就会被丢弃。对于大容量测试，创建多个收件箱。

我可以向收件箱 URL 发送 GET 请求吗？

不可以。收件箱接收 URL 只接受 POST 请求。 GET 请求返回 404。这与大多数 Webhook 提供程序的行为相匹配。

收件箱 URL 是否可以公开访问？

是的。任何知道收件箱 URL 的人都可以向其发送有效负载。收件箱 ID 是一个 8 个字符的随机十六进制字符串，因此很难猜测。不要将敏感生产数据发送到测试收件箱。

我需要 API 密钥来创建收件箱吗？

端点以每分钟 5 个请求的速度进行匿名访问（基于 IP 的速率限制）。 API 密钥消除了速率限制。

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