1. 范围
本规范定义了追溯系统与MES、ERP、WMS之间的数据交换接口,包括工单下发、生产报工、质量结果回传、物料追溯等场景。
2. 接口协议
采用RESTful API,数据格式为JSON,编码UTF-8。认证方式为OAuth2.0 client credentials。
3. 主要接口列表
- POST /api/v1/workorders – 创建工单
- GET /api/v1/workorders/{id} – 查询工单详情
- POST /api/v1/trace-events – 上报追溯事件
- GET /api/v1/trace/{productId} – 正向追溯查询
4. 数据模型
详见附录A:JSON Schema定义。

