Webhook 调试工具

关于 Webhook 调试工具

Webhook 是一种 HTTP 回调——一种服务在事件发生时向另一服务实时发送数据的方式。与传统轮询（客户端反复询问更新）不同，webhook 在事件发生时会立即将数据推送到预先配置的 URL。这使得它们更高效，并能够实现实时集成。

Webhook 是事件驱动架构的基础。GitHub（推送事件、拉取请求）、Stripe（支付事件）、Slack（斜杠命令、交互）等无数服务都使用 webhook 通知外部系统重要事件。单个 webhook 载荷可以包含处理事件所需的一切信息。

调试 webhook 可能具有挑战性，因为数据是从外部服务流向你的服务器。你需要精确看到服务发送的头部和主体。此工具提供一个唯一的、可公开访问的 URL，实时捕获每个传入请求，向你显示完整的 HTTP 请求，包括方法、头部、查询参数和主体内容。

常见的 webhook 模式包括：通过 HMAC 签名验证发送者、实现幂等键以处理重复投递、以及使用指数退避进行重试。大多数 webhook 发送者期望在几秒内收到 2xx 响应；非 2xx 响应会触发重试逻辑，如果处理不当可能迅速淹没你的系统。

在构建 webhook 接收器时，始终验证来源。大多数服务使用 HMAC-SHA256 和密钥签名其载荷。将计算出的签名与请求头部中的签名（例如 GitHub 的 X-Hub-Signature-256）进行比较。这确保请求确实来自预期服务且未被篡改。