跳到正文
EquatorOps
集成 事件驱动的运营

事件驱动的集成,投递有保障,团队用得放心。

EquatorOps 的集成层基于事务性发件箱模式、签名 Webhook 和幂等保障构建,运营变更在 ERP、WMS 和合作伙伴系统之间始终保持同步。

Webhook

HMAC 签名

送达

重试 + 重放

集成

ERP · WMS · BI

能力

原生事件驱动

每个工作流程都会发出带签名的事件,并内置投递跟踪。

能力

事务性发件箱

运营变更与外发事件一起提交,避免数据不一致。

能力

幂等保障

可安全重放的集成,防止跨系统重复执行。

可靠性 + 安全

集成保障,内置于工作流程引擎。

集成层专为受监管的运营而设计。外发事件安全可靠、可放心重放,并与运营团队所依托的同一审计台账保持一致。

浏览 API 目录

事务性发件箱

运营变更与外发事件一起提交,确保数据一致。

  • 发件箱与台账在同一事务中写入
  • 保证分发顺序
  • 安全重试,不会重复执行

幂等 + 操作锁

可安全重放的工作流程,防止跨系统重复操作。

  • 写操作携带幂等键
  • 敏感工作流程启用操作锁
  • 关键流程具备防重放保障

Webhook 安全

借助加密签名和请求跟踪,确保投递安全。

  • HMAC 签名载荷
  • 请求 ID + 防重放保护
  • 支持密钥轮换

投递保障

  • 依托重试策略和死信路由,提供投递保障。
  • 事件消费者可设置检查点,安全地重放。
  • 审计追踪归租户所有,可随时导出。

Webhook 载荷

每个事件都带有可追溯字段,便于安全地重放消费。

{
  "event_type": "inventory.stock_received",
  "aggregate_id": "lpn_DEN01_0742",
  "schema_version": "1.0",
  "timestamp": "2024-01-15T14:32:00Z",
  "source_service": "inventory",
  "dedupe_key": "stock-rcv-0742-1705329120",
  "data": {
    "lpnSerial": "LPN-DEN01-0742",
    "skuCode": "WIDGET-A100",
    "quantity": 48,
    "transactionType": "RECEIPT"
  },
  "webhook_targets": ["customer_facing"],
  "tenant_context": {
    "organization_id": 42,
    "tenant_id": 1
  }
}

安全请求头

HMAC 签名和请求 ID 用于验签和防重放保护。

POST /your-webhook-endpoint HTTP/1.1
Content-Type: application/json

X-Honey-Signature: sha256=a1b2c3d4e5...
X-Honey-Timestamp: 1705329120
X-Honey-Request-Id: req_7f3a9c2b
X-Honey-Event-Type: inventory.stock_received
X-Honey-Schema-Version: 1.0
X-Honey-Delivery-Id: dlv_9x8y7z6w

用 Webhook 密钥做 HMAC-SHA256 验签,再把 timestamp.payload 与签名请求头比对。

集成模式

面向 ERP、WMS 和合作伙伴系统的具体流程。

采用标准集成模式,无需编写定制的胶水代码。每个工作流程发出的事件都与运营台账一致,下游系统可以放心使用这些载荷。

ERP 同步

台账更新和状态变化同步流向财务与计费系统。

WMS 交接

库存移动事件触发路由和履约更新。

计费导出

工单完工后,收入事件推送到计费管道。

合作伙伴签收

用安全的 Webhook 确认供应商收货和合规操作。

示例流程

1

库存移动 → Webhook

POST /api/v1/stock/receive

  • 经 /api/v1/stock/receive 提交库存移动
  • 发件箱分发带 HMAC 签名的库存事件
  • WMS 在其配置的 Webhook 端点接收事件
2

工单完工 → 计费

POST /api/v1/work-orders

  • 经 /api/v1/work-orders/{id} 更新工单状态
  • 计费导出事件携带幂等键进入队列
  • 财务系统凭 X-Honey-Request-Id 对账
3

质量关卡 → 放行

POST /api/v1/work-orders/operations/{id}/execute

  • 质量检验经工序执行接口判定通过
  • 合规 Webhook 携带 X-Honey-Signature 投递
  • 放行流程解锁库存和发运

互联记录

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

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

变更审查

背景信息一目了然

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

质量证据

关联记录

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

库存

运营履历

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

集成

把事件驱动的集成保障带进您的运营技术栈。

让 ERP、WMS 和合作伙伴系统与 EquatorOps 运营台账保持一致。