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