HTTP / 请求调试

Webhook 在线测试看清实际收到的回调

手动创建临时地址,让发送方投递测试请求,再检查实际抵达的内容。

Webhook 在线测试

收到的事件

接收地址

尚未收到请求。

从 Webhook 提供商或 HTTP 客户端发送测试请求。知道地址的人可以投递,只有本页持有读取密钥。

尚未收到请求。

请求详情

选择一条事件,查看请求头和请求体。

请求会到达 HeyUtils 服务器并暂存 30 分钟,到期删除。常见敏感请求头入库前脱敏;路径、查询参数和请求体不会自动脱敏。请只发测试数据。

筛选已捕获事件

创建收件箱后会得到接收地址。

支付沙箱显示已发回调,而自己的服务没有日志时,Webhook 在线测试可以提供一个独立的接收点。把临时回调地址填入发送方测试配置,再对照捕获的请求方法、路径、查询参数、请求头请求体排查问题。

这个 Webhook 收件箱属于短时服务,不是生产回调入口。公开地址只负责接收,当前浏览器页面持有另一个管理密钥才能读事件。作为 Webhook 测试工具,它帮助你先确认发送方究竟发来了什么。

为什么使用 Webhook 在线测试

公开地址用于接收,读取权限另由密钥控制。

接收地址与读取密钥分开

发送方只需临时地址,无法凭地址打开事件列表。Webhook 在线测试把常见认证请求头在入库前遮盖;路径、查询参数和请求体保持原样,方便定位回调,但仍应避免发送真实机密。

公开请求进入收件箱,另一把私有密钥才可打开事件列表。

重放只发生在本收件箱内

确认后会把已捕获事件复制成带标记的新记录,便于核对筛选和重复投递。它不会请求任意外部 URL,也不会触发你的业务处理器;这点与转发器不同。

一条已收到的请求在同一个收件箱里变成带标记的第二条记录。

在半小时有效期内排查回调

01

准备好发送方再创建

30 分钟倒计时从创建地址时开始,而不是从首条请求到达时开始。管理密钥只保存在当前页面内存中;刷新页面会失去旧收件箱的读取权限。

02

先核对路径与方法

页面可见时每 3 秒刷新一次。先看方法、路径和查询参数,再看已脱敏请求头与请求体;无法按 UTF-8 解码的二进制内容会显示为 Base64。

03

确认筛选结果再导出

方法与文本筛选只影响当前已捕获事件,不改变接收规则。修改筛选时导出短暂禁用,待列表更新后下载的 JSON 才对应可见结果。

接收、检查和整理真实 HTTP 回调

真实 HTTP 接收

Webhook 在线测试接受 GET、POST、PUT、PATCH、DELETE、HEAD 和 OPTIONS。每条记录保存时间、方法、路径、查询参数、脱敏请求头及最多 64 KiB 的请求体;超限请求不会被截断后当作完整事件。

按方法和内容定位

筛选请求方法,或搜索已保存的路径与请求体,可以在重试事件中找目标。复制详情与下载 JSON 使用同一份已筛选数据,不包含管理密钥。

固定时间与容量

每个随机地址创建后仅保留 30 分钟,最多 50 条事件。服务端到期清除内容;页面隐藏时停止轮询,需要立即确认投递时可手动刷新。

发送测试数据前要知道的边界

这是服务器端临时服务
发送方调用地址时,请求内容会上传到 HeyUtils。不要发送生产密钥或用户资料。Authorization、Cookie 等常见请求头在保存前脱敏,但路径、查询参数、自定义字段和请求体不自动脱敏。
重放不等于转发
重放只在本收件箱内新增一条副本,并占用 50 条额度中的一条;不会访问业务服务器、建立本地隧道、验证 HMAC 签名或自定义 HTTP 回执。需要这些能力时请在自己的环境验证。
到期与超限直接拒绝
30 分钟期限不会因收到新事件而延长。请求体超过 64 KiB、请求头超过 8 KiB、收件箱已满或短时请求过密都会报错,不会保存残缺记录;不提供永久历史、共享页面或立即删除按钮。

Webhook 在线测试常见问题

临时地址能使用多久?

地址创建后可用 30 分钟,届时服务端删除记录并拒绝新请求。即使期限未到,刷新本页也会丢失只保存在内存中的管理密钥。

可以发送生产密码或密钥吗?

不建议。常见认证请求头会在保存前遮盖,但路径、查询参数和请求体可能原样显示;Webhook 在线测试应只接收专门准备的测试数据。

支持哪些请求方法?

支持 GET、POST、PUT、PATCH、DELETE、HEAD 和 OPTIONS;每条请求体最多 64 KiB。这个工具只记录到达的请求,并不保证发送方或签名有效。

如何验证 Webhook 签名?

本页不验证签名。不同提供商使用不同原始请求体和算法;请在自己的环境按提供商文档校验,避免把生产签名密钥上传到临时服务。

此工具支持哪些 Webhook 提供商?

只要提供商能把 HTTP 请求发送到临时 HTTPS 地址,就可以用来检查回调。这里不内建某家服务的协议,也不向发送方自动发测试请求。

回调行为和预期不同?

用 Webhook 在线测试接收一次测试回调

发送方准备好后再创建地址,在 30 分钟窗口内检查实际到达的事件。

请求在 HeyUtils 服务器暂存,到期删除。