Webhook 调用历史

你的 Webhook 不再是 黑盒。

记录每一次传入调用的请求头、负载、渲染后的消息和处理结果。当集成方信誓旦旦地说已经发出请求时,你可以亲自核实。

请求头与负载明确的错误原因最长保留 1 年更新于
你将获得

失败的 Webhook 不会告诉你的一切

推送通知没有到达时,问题总是一样的:发送方到底有没有调用?如果调用了,我们这边哪里出了问题?

每个请求的日志

记录每一次调用,按最新排序,支持内联展开。方法、来源 IP、大小和内容类型一目了然。

完整的请求头与负载

按原样展示完整请求头和原始请求体,方便你对比服务声称发送的内容与实际发送的内容。

模板生成的内容

在负载旁边查看模板根据负载渲染出的消息。模板出错不再靠猜。

明确的失败原因

失败时会给出具体原因:JSON 无效、缺少 %path% 导致消息为空,或 Webhook 未启用。

脱敏与加密

Authorization、Cookie 和 API 密钥相关的请求头在存储前会被脱敏,负载则使用你的密钥加密存储。

筛选、翻页或获取

在控制台中按结果筛选并翻页查看历史,也可以通过 API 获取数据,自行分析。

快速开始

确认究竟收到了什么

1

将服务指向它

像平时一样创建一个 Webhook,并把你的服务指向它的 URL。

2

打开调用历史

在控制台中打开该 Webhook,点击进入它的调用历史。

3

展开具体调用

展开任意一次调用,查看请求头、请求体、渲染后的消息以及失败原因。

Webhook 调用历史的工作原理

每个到达你 Webhook URL 的请求都会在处理前被记录,处理完成后再附上结果。这意味着失败的调用和成功的调用同样清晰可见,包括发送到你已禁用并早已忘记的 Webhook 的调用。

在控制台中打开某个 Webhook,即可看到它的调用历史,按最新排序。每一行都可以展开,查看查询字符串、完整请求头,以及经过 JSON 格式化的请求体。同样的数据也可以通过 REST API 获取,并按 success 和 error 进行筛选。

排查模板问题

最常见的失败通常不是网络问题,而是 %path% 占位符指向了发送方实际并未发送的字段。调用历史会把原始负载和模板生成的消息并排展示,通常几秒钟就能发现问题所在。

隐私

负载中往往包含敏感信息,因此负载会使用你的专属密钥加密存储,Authorization、Cookie 和 API 密钥相关的请求头在存储前会被替换为 [redacted]。保留期从免费套餐的 7 天到大型版的完整 1 年不等。

常见问题

常见问题解答

时间戳、HTTP 方法、来源 IP、内容类型、查询字符串、完整请求头、原始请求体、负载大小、模板生成的消息、是否创建了推送通知;如果没有创建,还会记录失败原因,以及处理耗时。

免费套餐保留 7 天,入门版 30 天,中级版 90 天,大型版 365 天。超出保留期的调用会被自动删除;单个 Webhook 的记录超过 1,000 条时,最早的记录也会被自动删除。

是的。负载会使用你的专属密钥加密存储,与消息内容的加密方式相同;Authorization、Cookie 和 API 密钥相关的请求头在存储前会被替换为 [redacted]。

调用历史会告诉你具体原因。如果完全没有记录,说明发送方的请求没有到达我们这里。如果某次调用有错误记录,你会看到具体原因:JSON 无效、%path% 在负载中不存在导致消息为空,或 Webhook 已被禁用。

在控制台中打开对应的 Webhook,就能看到它的调用历史,按最新排序,每条调用都可以展开查看。如果你更想通过程序获取,也可以使用 REST 端点,并按成功或错误进行筛选。

可以。免费套餐的保留期为 7 天。如果需要更长的保留期,可以升级到付费套餐。

不必再猜推送通知为什么没收到

把服务指向一个 Pocket Alert Webhook,它发出的每一次调用都会被记录下来,无论推送通知是否成功发出。