失败的 Webhook 不会告诉你的一切
推送通知没有到达时,问题总是一样的:发送方到底有没有调用?如果调用了,我们这边哪里出了问题?
每个请求的日志
记录每一次调用,按最新排序,支持内联展开。方法、来源 IP、大小和内容类型一目了然。
完整的请求头与负载
按原样展示完整请求头和原始请求体,方便你对比服务声称发送的内容与实际发送的内容。
模板生成的内容
在负载旁边查看模板根据负载渲染出的消息。模板出错不再靠猜。
明确的失败原因
失败时会给出具体原因:JSON 无效、缺少 %path% 导致消息为空,或 Webhook 未启用。
脱敏与加密
Authorization、Cookie 和 API 密钥相关的请求头在存储前会被脱敏,负载则使用你的密钥加密存储。
筛选、翻页或获取
在控制台中按结果筛选并翻页查看历史,也可以通过 API 获取数据,自行分析。
确认究竟收到了什么
将服务指向它
像平时一样创建一个 Webhook,并把你的服务指向它的 URL。
打开调用历史
在控制台中打开该 Webhook,点击进入它的调用历史。
展开具体调用
展开任意一次调用,查看请求头、请求体、渲染后的消息以及失败原因。
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 天。如果需要更长的保留期,可以升级到付费套餐。