接口对接
WMS / WCS / ERP 对接说明
说明货架安全监测平台如何通过 API KEY、Webhook、WebSocket 与仓储和企业管理系统协同。
对接目标
对接不是把所有数据简单同步出去，而是让设备状态、告警事件、风险等级和处置结果进入客户既有流程，支撑库位管控、运维派单、管理看板和审计归档。
推荐接口组合
API KEY 适合受控查询，Webhook 适合告警事件推送，WebSocket 适合控制台和大屏实时刷新。项目应按实时性、安全边界和系统承载能力选择组合。
数据边界
接口开放范围应以合同和项目边界为准。设备基础信息、在线状态、告警事件和工单结果可按需开放，完整风险分析、报告和原始监测数据应结合权限审计谨慎处理。
为什么要优先做事件而不是全量同步
很多企业在对接时容易希望把全部数据一次性推到 WMS 或 ERP 中，但实际更适合先从事件型数据做起，比如在线状态变化、告警触发、工单完成和复核结果。事件型对接更容易落地，也更不容易打乱客户已有的数据治理结构。
对接成功的关键
真正稳定的系统对接，关键不是接口数量，而是字段定义一致、事件语义明确、失败重试可控、审计留痕完整。把这些基础工作做好，后续无论扩展到 BI 看板、消息中心还是运维平台，都会更加顺畅。
| 对接对象 | 推荐数据 | 典型用途 |
|---|---|---|
| WMS | 货架区域、库位状态、风险等级、封控建议 | 辅助库位管理和作业限制 |
| WCS | 严重告警、区域状态、设备联动事件 | 与堆垛机、输送线、AGV/RGV 等设备策略协同 |
| ERP | 项目资产、维保记录、工单归档、费用信息 | 支撑资产管理和维保流程 |
| BI / 大屏 | 在线率、风险分布、告警趋势、闭环效率 | 用于管理层态势展示和安全复盘 |
接口联调清单
接口联调建议从低风险字段开始，逐步扩展到事件和工单闭环，避免一次性开放过多数据导致权限、性能和责任边界不清。
- 确认系统边界：明确哪些系统是主数据来源，哪些系统只接收事件。
- 统一编码：仓库、货架、立柱、设备、部门和人员编码要保持一致。
- 定义事件：明确告警触发、告警恢复、工单创建、工单完成等事件语义。
- 校验安全：配置 API KEY、IP 白名单、签名校验、失败重试和日志审计。
- 联调演练：使用测试点位模拟告警、恢复、处置和归档全过程。