UD5工具箱
快速开始：接收第一个Webhook
第一步，打开Webhook请求捕获器页面。点击页面顶部的"生成URL"按钮。工具会向webhook.site的API发送请求，生成一个唯一的临时URL。URL会显示在页面顶部的URL卡片中。第二步，点击"复制URL"按钮，将URL复制到剪贴板。第三步，打开您要测试的第三方服务的Webhook设置页面（例如GitHub的Settings -> Webhooks）。将复制的URL粘贴到Webhook URL输入框中。根据需要配置触发事件（如push events、pull requests等）。保存配置。第四步，触发一个Webhook事件（例如向GitHub仓库push一次代码）。第五步，回到本工具页面，等待几秒钟。请求列表中应该会出现新收到的Webhook请求。如果列表没有更新，点击"刷新"按钮手动查询。第六步，点击请求条目查看详情，检查请求头和请求体是否符合预期。
使用模拟请求快速体验
如果您只是想了解工具的功能，而不想配置真实的第三方服务，可以使用模拟请求功能。第一步，打开工具页面，生成一个临时URL（如果还没有URL的话）。第二步，点击"发送模拟请求"按钮。工具会向当前URL发送一个包含模拟Webhook数据的POST请求。第三步，等待1-2秒，请求列表中应该会出现新条目。第四步，点击该条目查看详情。您可以看到模拟的请求头（包括Content-Type: application/json、User-Agent等）和请求体（包含模拟的事件数据、时间戳等）。请求体中的JSON数据会自动格式化，方便查看嵌套结构。第五步，再次点击"发送模拟请求"按钮，观察请求列表的变化。每次模拟请求都会使用不同的数据，确保您能看到不同的请求内容。通过模拟请求，您可以快速熟悉工具的界面布局和功能操作。
调试GitHub Webhook
GitHub Webhook是最常用的Webhook场景之一。以下是如何使用本工具调试GitHub Webhook的详细步骤。第一步，生成临时URL并复制。第二步，打开GitHub仓库 -> Settings -> Webhooks -> Add webhook。第三步，在Payload URL中粘贴复制的URL。第四步，Content type选择application/json（推荐）。第五步，在Secret中输入一个自定义密钥（用于验证Webhook签名）。第六步，在Which events would you like to trigger this webhook中选择触发事件（如Just the push event）。第七步，确保Active复选框已勾选。第八步，点击Add webhook保存配置。第九步，GitHub会立即发送一个ping事件到您的URL。回到本工具页面，查看收到的ping请求。第十步，执行一个触发事件（如push代码），查看实际的Webhook请求。检查请求头中的X-GitHub-Event（事件类型）、X-Hub-Signature-256（签名）等字段。检查请求体中的仓库信息、提交内容、作者信息等。如果请求没有到达工具，检查GitHub Webhook设置页面的Recent Deliveries，查看发送状态和响应。
调试支付Webhook
支付平台（如Stripe、PayPal、微信支付）的Webhook对于处理支付结果至关重要。以Stripe为例，调试步骤如下。第一步，生成临时URL。第二步，登录Stripe Dashboard -> Developers -> Webhooks -> Add endpoint。第三步，粘贴临时URL到Endpoint URL。第四步，选择监听的事件（如payment_intent.succeeded、charge.refunded等）。第五步，点击Add endpoint保存。第六步，使用Stripe测试模式创建一个支付（如使用Stripe CLI或测试密钥调用API）。第七步，回到本工具页面，查看收到的支付事件Webhook。检查请求头中的Stripe-Signature头（用于验证Webhook真实性）。检查请求体中的事件类型、支付金额、货币、状态等信息。第八步，如果需要验证Webhook签名，可以使用Stripe提供的签名验证库，使用Webhook Secret和请求体来验证签名。注意：在测试阶段，使用Stripe的测试模式API密钥，避免产生真实交易。
管理URL和请求记录
工具提供了完整的URL和请求记录管理功能。URL管理：创建URL后，URL卡片会一直显示在页面顶部，直到URL过期（通常7天）或用户重新生成。如果当前URL不再需要，点击"重新生成"按钮创建新URL，旧URL将立即失效。请求记录管理：所有收到的请求都会在列表中显示，按时间倒序排列。当测试结束后，点击"清空"按钮清除所有请求记录，释放内存。暂停/恢复：如果需要暂时停止接收请求（例如在调试期间不想被新请求打扰），点击"暂停"按钮。已捕获的请求仍然保留，只是不再轮询新请求。恢复后会立即查询新请求。刷新：在暂停状态下或需要立即查看最新请求时，点击"刷新"按钮手动触发查询。URL信息卡片显示URL的创建时间、UUID和有效期，帮助您管理测试环境。建议在每次测试开始时清空旧的请求记录，确保测试数据的整洁。
分析请求数据
收到Webhook请求后，如何有效地分析请求数据。首先，检查请求的基本信息：HTTP方法（通常是POST）、URL路径和查询参数。然后，查看请求头区域，重点关注Content-Type（决定请求体格式）、User-Agent（标识发送方）、Authorization（认证信息）和自定义头（如X-GitHub-Event、Stripe-Signature等）。接着，查看请求体。如果是JSON格式，检查JSON结构是否完整、字段名是否正确、数据类型是否符合预期。检查业务相关字段：事件类型、对象ID、时间戳、状态等。如果是表单数据，检查键值对是否正确。最后，检查查询参数（如果有的话），某些Webhook会通过URL参数传递额外信息。将捕获的请求数据与第三方服务的Webhook文档进行对比，确认所有必要字段都存在且格式正确。如果发现字段缺失或格式错误，可能是第三方服务的配置问题或API版本问题。