可靠性 + 安全
集成保障,内置于工作流程引擎。
集成层专为受监管的运营而设计。外发事件安全可靠、可放心重放,并与运营团队所依托的同一审计台账保持一致。
事务性发件箱
运营变更与外发事件一起提交,确保数据一致。
- 发件箱与台账在同一事务中写入
- 保证分发顺序
- 安全重试,不会重复执行
幂等 + 操作锁
可安全重放的工作流程,防止跨系统重复操作。
- 写操作携带幂等键
- 敏感工作流程启用操作锁
- 关键流程具备防重放保障
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 投递
- 放行流程解锁库存和发运