跳到正文
EquatorOps
功能深度解析 集成 可靠性 事件驱动

Webhook 与事件驱动集成

部署合作伙伴真正信得过的 Webhook。事务性发件箱保障、HMAC 签名负载和完整的重放工具,让每一项集成都可靠、可审计。

功能概况

核心引擎

安全与可靠性、取证分析

适用场景

需要用运营事件对接 ERP、WMS 或合作伙伴系统的团队

主要产出

签名领域事件、Webhook 订阅、可重放的投递日志

问题

投递只求“尽力而为”,运营事件就不可信。

工单完工、库存移动、质量关卡通过时,团队需要可靠、可审计的信号。没有投递保障,下游系统的数据就会走样,运营人员也会对集成层失去信心。

运营影响

  • Webhook 负载静默失败,交接环节被漏掉
  • 缺少幂等保护,导致重复处理
  • ERP、WMS 与客户门户之间只能人工对账

引擎

安全与可靠性、取证分析

事件与运营变更在同一事务内持久化,再通过签名 Webhook 和可重放的投递日志分发,集成方可以信赖每一个信号。

  • DomainEvent 记录先写入发件箱再发布
  • HMAC 签名,支持密钥轮换窗口
  • 失败通知可通过重放端点和投递日志补发
  • 负载结构稳定,附带去重键,便于消费方实现幂等

引擎价值

该引擎以可复用的运营逻辑支撑这项功能,确保每个工作流程都与租户自有的数据模型保持一致。

可与 API、工作流程和数据对象协同运作,不会割断谱系或合规记录链。

工作流程

从信号到行动,流程如何推进。

第 1 步

发出面向客户的领域事件

服务写入 DomainEvent 记录,包含结构版本、去重键和租户上下文。

第 2 步

写入发件箱并加入投递队列

发件箱处理程序为已订阅的事件类型排队投递 Webhook。

第 3 步

投递签名 Webhook

WebhookService 为负载签名、重试投递,并记录响应元数据。

第 4 步

监控与重放

集成团队查看投递日志并重放事件,在下游故障后恢复数据。

数据对象

数据对象归租户所有,驱动下游系统。

每个工作流程都会产出结构化记录,且始终留在客户自己的数据域内。

DomainEvent

租户自有的发件箱事件,记录事件类型、负载、结构版本和去重键。

WebhookSubscription

由客户定义的事件投递目标、过滤条件和密钥。

WebhookDeliveryLog

每个 Webhook 的投递尝试、响应码和重试计划。

API 预览

团队最先集成的端点。

API 在各行业保持一致,事件钩子结构稳定。

查看开发者文档
POST /api/v1/portal/webhooks/subscribe

为客户事件类型创建 Webhook 订阅。

POST /api/v1/portal/webhooks/{subscription_id}/rotate-secret

零停机轮换 HMAC 密钥。

GET /api/v1/integrations/events

列出发件箱中面向客户的领域事件。

POST /api/v1/integrations/events/{event_id}/replay

重放指定事件的 Webhook 投递。

GET /api/v1/integrations/webhooks

分页查看 Webhook 投递日志。

跨行业示例

同一引擎,多种落地。

同一套运营逻辑可适配制造、医疗健康、物流和受监管行业。

制造业

工单完工即触发 ERP 计费和下游排程更新。

物流

库存移动 Webhook 向 TMS 推送发运状态更新。

医疗健康

QC 关卡结果连同可供审核的证据推送至 LIMS 系统。

金融科技

付款确认和结算事件同步到客户门户。

零售

履约里程碑直接更新到电商平台,无需轮询。

能源

检验和合规事件触发合作伙伴签收。

嵌入式运营

制造状态、检验结果和合规信号通过 Webhook 投递送达平台客户。

常见问题

为安全、数据和上线团队解答疑问。

Webhook 提供怎样的投递保障?

事件至少投递一次,并提供投递日志和重放支持。消费方应使用去重键实现幂等。

Webhook 负载如何保障安全?

WebhookService 用 HMAC 为每个负载签名,密钥可在双重签名窗口内轮换。

错过的事件能重放吗?

可以。事件重放端点会新建一条投递日志并加入队列,下游系统在故障后即可恢复。

事件归租户所有吗?

是的。DomainEvent 记录和投递日志存放在租户数据存储中,供审计和导出流程使用。

互联记录

决策与证据,始终放在一起。

追踪变更、工作以及支撑审查的记录之间的关联。

变更审查

背景信息一目了然

把拟议变更关联到需要审查的记录和依赖关系(限平台支持的类型)。

质量证据

关联记录

发现项、措施和支持性证据随工作同步留存,随时可查。

库存

运营履历

追踪按所配置流程采集的物料、搬运和保管记录。

事件投递

部署合作伙伴真正信得过的 Webhook。

依托事务性发件箱保障、HMAC 签名和重放工具,让集成稳定可靠。