Hooks · 客户使用文档

用户需要准备

一个能发送 Webhook 的服务；无需自建接收服务器。

工作台操作步骤

1. 01创建收件箱并复制 URL。
2. 02配置发送方并触发测试事件。
3. 03查看记录与正文，必要时重放。

调用与集成示例

将测试支付 Webhook 发到收件箱，检查 JSON 并在修复后重放。

# After creating an inbox, copy its receiving URL.
curl -i -X POST "$INBOX_URL" \
  -H 'Content-Type: application/json' \
  --data '{"event":"payment.test","orderId":"sample-123"}'
# Return to the workspace and open Received events.

示例包含占位值；请替换 $BASE_URL、$SESSION_TOKEN 和生成的 URL。不要将令牌或 API 密钥发布到网站或仓库。

管理 API 入口

POST /api/picosvc/hooks/inboxes

输入收件箱名称，并将生成的 URL 配置给发送方。

接收 URL、事件历史、请求头、正文和重放结果。

不支持的功能

不会代替发送方签名验证或生产处理器。

功能比较与资料来源

捕获请求的工作流：按收件箱接收、查看历史并向目标重放。

Webhook.site：文档介绍列出和查看已捕获请求的 API。