系统集成与开放接口说明

接口类型

1. 按方向分

• 入向接口：外部系统写入 MES（如 ERP 下发生产订单）
• 出向接口：MES 推送给外部（如报工结果回传 ERP）

2. 按触发方式分

• API 调用：实时请求-响应
• 消息推送：MQ/消息队列，异步
• 文件交换：定时导出/导入文件（适合大数据量、低频场景）

认证方式

常见三种：

1. API Key：简单，适合内部系统
2. OAuth2 / Token：标准，支持过期刷新
3. 签名验证：请求参数+密钥+时间戳签名，防篡改

建议：内部系统用 Token，跨企业对接用签名。

调用规范

请求格式

{
  "bizNo": "WO20260910001",
  "data": { ... }
}

响应格式

{
  "code": 0,
  "message": "success",
  "data": { ... }
}

关键约定

• 幂等性：用 bizNo 做幂等键，重复调用不产生重复数据
• 字段类型：日期统一格式（建议 YYYY-MM-DD HH:mm:ss 或时间戳）
• 编码：统一 UTF-8
• 分页：大数据量必须分页

对接实施流程

1. 需求确认：明确数据流向、字段映射、触发时机
2. 接口设计：定义请求/响应结构
3. 联调测试：在测试环境验证
4. 灰度上线：先小流量验证
5. 监控运维：接口成功率、耗时监控

百华智造 MES 对应说明

[待补充：百华智造 MES 的开放接口清单、认证方式、SDK 或文档获取方式]