Webhook 与事件驱动集成
部署合作伙伴真正信得过的 Webhook。事务性发件箱保障、HMAC 签名负载和完整的重放工具,让每一项集成都可靠、可审计。
功能概况
核心引擎
安全与可靠性、取证分析
适用场景
需要用运营事件对接 ERP、WMS 或合作伙伴系统的团队
主要产出
签名领域事件、Webhook 订阅、可重放的投递日志
问题
投递只求“尽力而为”,运营事件就不可信。
工单完工、库存移动、质量关卡通过时,团队需要可靠、可审计的信号。没有投递保障,下游系统的数据就会走样,运营人员也会对集成层失去信心。
运营影响
- Webhook 负载静默失败,交接环节被漏掉
- 缺少幂等保护,导致重复处理
- ERP、WMS 与客户门户之间只能人工对账
引擎
安全与可靠性、取证分析
事件与运营变更在同一事务内持久化,再通过签名 Webhook 和可重放的投递日志分发,集成方可以信赖每一个信号。
- DomainEvent 记录先写入发件箱再发布
- HMAC 签名,支持密钥轮换窗口
- 失败通知可通过重放端点和投递日志补发
- 负载结构稳定,附带去重键,便于消费方实现幂等
引擎价值
该引擎以可复用的运营逻辑支撑这项功能,确保每个工作流程都与租户自有的数据模型保持一致。
工作流程
从信号到行动,流程如何推进。
第 1 步
发出面向客户的领域事件
服务写入 DomainEvent 记录,包含结构版本、去重键和租户上下文。
第 2 步
写入发件箱并加入投递队列
发件箱处理程序为已订阅的事件类型排队投递 Webhook。
第 3 步
投递签名 Webhook
WebhookService 为负载签名、重试投递,并记录响应元数据。
第 4 步
监控与重放
集成团队查看投递日志并重放事件,在下游故障后恢复数据。
数据对象
数据对象归租户所有,驱动下游系统。
每个工作流程都会产出结构化记录,且始终留在客户自己的数据域内。
DomainEvent
租户自有的发件箱事件,记录事件类型、负载、结构版本和去重键。
WebhookSubscription
由客户定义的事件投递目标、过滤条件和密钥。
WebhookDeliveryLog
每个 Webhook 的投递尝试、响应码和重试计划。
API 预览
团队最先集成的端点。
API 在各行业保持一致,事件钩子结构稳定。
/api/v1/portal/webhooks/subscribe 为客户事件类型创建 Webhook 订阅。
/api/v1/portal/webhooks/{subscription_id}/rotate-secret 零停机轮换 HMAC 密钥。
/api/v1/integrations/events 列出发件箱中面向客户的领域事件。
/api/v1/integrations/events/{event_id}/replay 重放指定事件的 Webhook 投递。
/api/v1/integrations/webhooks 分页查看 Webhook 投递日志。
跨行业示例
同一引擎,多种落地。
同一套运营逻辑可适配制造、医疗健康、物流和受监管行业。
制造业
工单完工即触发 ERP 计费和下游排程更新。
物流
库存移动 Webhook 向 TMS 推送发运状态更新。
医疗健康
QC 关卡结果连同可供审核的证据推送至 LIMS 系统。
金融科技
付款确认和结算事件同步到客户门户。
零售
履约里程碑直接更新到电商平台,无需轮询。
能源
检验和合规事件触发合作伙伴签收。
嵌入式运营
制造状态、检验结果和合规信号通过 Webhook 投递送达平台客户。
常见问题
为安全、数据和上线团队解答疑问。
Webhook 提供怎样的投递保障?
事件至少投递一次,并提供投递日志和重放支持。消费方应使用去重键实现幂等。
Webhook 负载如何保障安全?
WebhookService 用 HMAC 为每个负载签名,密钥可在双重签名窗口内轮换。
错过的事件能重放吗?
可以。事件重放端点会新建一条投递日志并加入队列,下游系统在故障后即可恢复。
事件归租户所有吗?
是的。DomainEvent 记录和投递日志存放在租户数据存储中,供审计和导出流程使用。