Workflow Hub

Webhook 基础:更清晰的调试工作流

当你主要关心如何捕获请求、看清楚内容、转发到 localhost,或在修复后重放——从这里开始。

为什么「工作流优先」能更快排障

很多 Webhook 问题第一眼像厂商问题——Stripe 签名挂、GitHub 没投递、Shopify 静默失败——但底层往往是同一套流程:证明请求能到公网地址、看清它到底是什么、把它送进本地环境、再反复重放直到处理器通过。从工作流而不是从厂商入手,能更快判断坏在哪一层。下面四步就是这个流程;每步链到对应产品页,可立刻动手。当你撞上厂商特有的墙(签名、HMAC、事件类型边角),页面底部的各厂商 Hub 会接棒。

四步跑通 Webhook

从与你现状匹配的步骤进入即可,不必每次四步全走。

该用哪个工具

按你当下的处境选起点。

你的处境 更合适工具 原因
「不确定服务商有没有发任何东西」 Request Bin 提供公网端点捕获每次投递,先确认上游侧是否正常。
「能看到请求,但总觉得哪里不对」 Request Viewer 格式化展示 headers、body 与状态,比纯日志或控制台更快定位异常。
「需要真实流量打到本地服务」 本地转发 把线上捕获的流量送进本地处理器,无需部署或开端口。
「修完 bug,想用同一份 payload 再测一次」 重放 复用已捕获请求验证修复,无需在上游重复触发。
「签名验证一直失败」 调试器 + Viewer 对照 raw body 与 headers,区分密钥、解析顺序或时间问题。

按厂商深入

遇到厂商特有障碍时再切换这些 Hub。

值得接着打开的文档

常见问题

必须按四步全部走一遍吗?

不必。从与你当前处境匹配的步骤切入:投递已确认就跳过 bin;只需要重放就直达重放。

这些工作流适用于任意 Webhook 发送方吗?

适用。捕获 → 检查 → 转发 → 重放与具体厂商无关,Stripe、GitHub、Shopify、Slack 及其他 HTTP 回调都同理。

request bin 和 webhook 调试器有什么区别?

bin 侧重捕获与展示;调试器在此基础上通常还提供转发、重放、签名相关能力与更持久的历史记录(以产品为准)。

什么时候从工作流指南切到「某厂商」专题?

当你遇到厂商特有问题时——例如 Stripe 签名、GitHub ping、Shopify HMAC。工作流解决通用分层;专题解决厂商差异。