文档

投递日志与测试

Webhook 设置面板为每个端点提供内置投递日志。可用它确认事件是否到达服务器、诊断失败,并发送新的示例载荷,无需触发真实活动。

查看投递日志

1

打开设置 → Webhook

前往 Dashboard → Settings → Webhooks.
2

展开 Webhook 行

点击 投递日志 按钮,位于任意 Webhook 卡片上。显示最近 50 次投递尝试,最新在前。
3

检查每个条目

每行显示事件类型、HTTP 状态码、响应时间、时间戳和任何错误信息。

日志字段

字段描述
事件触发的事件类型(例如 post.saved)
状态端点返回的 HTTP 状态。 null 如果超时或连接被拒绝。
响应时间从发送到接收最终响应字节的往返时间,单位为毫秒。
成功绿色勾号 = HTTP 2xx。红色叉号 = 其他任何结果。
错误投递失败时便于理解的错误信息(例如 Request timed out (10s)).
送达时间投递尝试的 UTC 时间戳。

发送测试事件

1

展开 Webhook 卡片

在 Settings → Webhooks,找到你的 webhook,然后点击 发送测试事件.
2

检查投递日志

测试投递会在几秒内出现在投递日志列表顶部。请确认能看到 200 状态。

测试事件是真实 HTTP 请求

测试事件与真实事件使用完全相同的处理流程,包括 HMAC 签名。签名验证代码会在测试中完整执行。

不自动重试

每次投递仅尝试一次。日志仅供诊断,失败的实时事件没有重放按钮。修复端点后,请使用“测试”验证修复结果。

常见失败原因

错误 / 状态可能原因修复
Request timed out (10s)服务器响应超过 10 秒返回 200 立即响应,然后异步处理
401签名验证失败请务必在解析 JSON 前读取原始请求体
404端点 URL 路径不存在再次检查 Savebase Webhook 设置中的 URL
500接收端存在未处理错误查看服务器日志中的异常
连接被拒绝 / 状态为空服务器宕机或 URL 错误确认服务器正在运行,且可公开访问