关键信息
- 分类
- Network
- 输入类型
- text, checkbox, select, number
- 输出类型
- html
- 样本覆盖
- 4
- 支持 API
- Yes
概览
一款专为开发者设计的 Webhook 调试与中继工具。它能一键生成唯一的接收地址,实时捕获并展示 HTTP 请求详情。支持配置签名密钥进行安全校验,并可根据请求方法或 Body 内容过滤请求。无论是本地开发调试,还是将线上 Webhook 流量安全地回放、中继到目标服务器,都能轻松搞定。
适用场景
- •在本地开发环境中需要接收并调试第三方平台(如 Stripe、GitHub)的 Webhook 通知时。
- •需要验证 Webhook 签名(HMAC)是否正确,排查鉴权失败问题时。
- •希望拦截特定条件的 Webhook 请求,并将其手动或自动回放到内网或测试服务器时。
工作原理
- •生成唯一的 Webhook 接收 URL,将其配置到第三方平台的 Webhook 设置中。
- •配置签名请求头和密钥(可选),工具将自动校验接收到的请求签名。
- •设置方法过滤(如仅 POST)或 Body 关键字过滤,精准捕获目标请求。
- •在面板中查看请求详情,或开启自动回放功能,将匹配的请求中继到指定的目标 URL。
使用场景
用户案例
1. 调试 Stripe 支付成功通知
后端开发者- 背景原因
- 正在接入 Stripe 支付,需要接收 invoice.paid 事件并在本地测试业务逻辑。
- 解决问题
- 本地环境无法直接接收公网 Webhook,且需要验证 Stripe 签名是否正确。
- 如何使用
- 生成接收地址填入 Stripe,配置回放目标为本地穿透地址,设置签名头为 stripe-signature,并过滤包含 "type":"invoice.paid" 的请求。
- 示例配置
-
{ "relayTargetUrl": "https://api.example.com/webhooks/stripe", "signatureSecret": "whsec_test_123", "signatureHeader": "stripe-signature", "methodFilter": "POST", "bodyMustContain": "\"type\":\"invoice.paid\"" } - 效果
- 成功捕获 Stripe 的支付通知,验证签名通过后,手动将请求回放到本地开发环境进行断点调试。
2. 按条件自动中继 GitHub Push 事件
DevOps 工程师- 背景原因
- 需要将 GitHub 仓库的 Push 事件推送到内部的自动化部署脚本,但只关心 main 分支的提交。
- 解决问题
- GitHub 原生 Webhook 无法细粒度过滤分支,导致内部服务器接收过多无效请求。
- 如何使用
- 使用本工具作为中间层,开启自动回放,并设置 Body 必须包含 "ref":"refs/heads/main"。
- 示例配置
-
{ "relayTargetUrl": "https://api.example.com/webhooks/github", "autoReplay": true, "methodFilter": "POST", "bodyMustContain": "\"ref\":\"refs/heads/main\"" } - 效果
- 工具自动拦截非 main 分支的推送,仅将符合条件的 Push 事件实时中继到内部服务器,减轻了服务器负载。
用 Samples 测试
network相关专题
常见问题
接收到的 Webhook 请求会保存多久?
工具最多保存您设置的“存储请求上限”数量的请求(默认 50 条,最高 200 条),超出后将自动覆盖最早的记录。
支持哪些类型的签名校验?
支持基于请求头(如 x-signature 或 stripe-signature)和密钥的 HMAC 签名校验。
可以只回放特定的请求吗?
可以。您可以通过设置“方法过滤”和“Body 必须包含”字段,仅拦截并回放符合条件的请求。
自动回放和手动回放有什么区别?
开启“自动回放匹配请求”后,符合过滤条件的请求到达时会立即转发到目标 URL;关闭则需在面板中手动点击回放。
回放目标 URL 可以是本地地址吗?
如果您的本地地址已通过内网穿透(如 Ngrok)暴露为公网 URL,则可以作为回放目标进行中继。