Subotiz Webhooks 通知日志 用于帮助商家查看 系统事件推送记录、发送结果及商家服务器返回的响应情况,并在需要时手动重发 Webhook 通知。通过通知日志与重发功能,商家可自行排查 Webhook 未送达或发送失败的问题,并在问题修复后完成事件补发。
通知日志功能说明
Webhook 通知日志用于记录系统向指定端点发送事件通知的全过程,包括发送状态、请求内容及目标端返回的响应结果。
- 访问路径: 前往 开发者 > Webhooks, 点击任一已创建的 Webhook 端点,即可进入该端点的通知日志页面。

- 日志记录范围: 仅展示最近 30 天内的 Webhook 通知记录;30 天之前的记录不会在当前页面中显示。

- 搜索与筛选规则: 日志页面支持按条件快速定位事件记录。
- 搜索: 支持按事件名称进行模糊搜索(例如:
.unpaid)。提示: 搜索仅支持事件名称匹配,暂不支持按订单号、订阅 ID、端点 URL 或请求内容搜索。
- 状态筛选: 可按发送状态筛选通知记录:
- 成功
- 失败

- 时间筛选: 支持按日期范围筛选通知记录,筛选范围仅限最近 30 天内。

Webhook 详情
- 可查看信息
- 事件名称:触发 Webhook 的事件类型(如
v2.subscription.unpaid)。 - 发送状态:该事件的发送结果。
- 创建时间:系统记录的通知创建与发送时间,用于日志排序与筛选。
日志默认按创建时间倒序排列,最新事件显示在最前。

- Webhook 发送状态: 通知日志中的状态用于表示单条 Webhook 事件的发送结果。
- 成功: Webhook 已成功发送至目标端点,并收到正常响应。
- 失败: Webhook 未成功发送至目标端点,或目标端返回错误响应。

- 通知详情说明: 点击任意一条通知记录,可查看该事件的完整发送详情。
- 基础信息
- 事件名称
- 端点 URL
- 发送状态
- 发送时间
- 请求耗时

- 请求内容
- 展示系统向商家服务器发送的原始请求数据。
- 支持一键复制,便于本地调试或问题排查。

- 响应内容
- 展示商家服务器返回给系统的原始响应内容。
- 可用于判断接口是否返回成功,以及定位错误原因。

- 使用场景
- 接口权限或鉴权配置修正完成
- 服务器异常已恢复
- 防火墙或网络限制已解除
- 需要重新触发业务处理逻辑
- 使用说明
- 在通知详情页点击 重发
- 系统将向原端点重新发送相同的请求内容
- 每次重发都会生成一条新的通知记录
- 原始记录不会被修改或覆盖
提示: 建议仅在确认接口问题已修复后使用重发功能,以避免产生重复或无效的业务请求。

Webhook 排查建议
当未收到 Webhook 通知时,建议按以下步骤排查:
- 在通知日志中确认是否存在对应事件记录。
- 查看事件状态是否为 失败。
- 打开通知详情,检查响应中的错误信息。
- 修复接口问题后,使用手动重发重新触发通知。

通过 Webhook 通知日志与手动重发功能,商家可清晰了解每一次事件的发送情况,并在无需人工协助的情况下完成问题排查与事件补发,从而提升系统对接的稳定性与处理效率。