开放 API 集成网关 MES-APIG｜对接 ERP/WMS/QMS 的标准化接口

一、产品概述

MES-APIG 是注塑 MES 的开放接口网关，把采集、SPC、参数库、排产、追溯的数据统一收口成一套对外接口，供 ERP、WMS、质量系统按标准协议取数。它的价值不在「能通」，在把鉴权、限流、字段映射全部收到网关层，上层系统只跟网关打交道、不碰底层时序库，新增一个系统只是接一个端点、不必重写对接。很多项目接口写死在业务模块里，换一个 ERP 厂商就重做一遍，根子就是缺网关这层统一收口。我们把接口标准化作为平台的前提，网关就是这套标准的执行点。

二、技术参数

参数	取值
接口协议	REST / OPC-UA / MQTT，供上层系统调用
鉴权	Token + 角色分级，网关层统一收口
限流	按端点与角色配额，防拉垮底座
数据映射	统一字段字典，屏蔽底层库差异
对接系统	ERP / WMS / 质量 / 设备系统
版本	接口版本号管理，向后兼容
审计	接口调用留痕，谁取了什么可查
部署	随平台私有化 / 厂内部署
高可用	网关冗余可选，断网缓存续传

查不到实测依据的取值写「需按实际送检/实测确认」，禁止编数字。

三、应用场景

• ERP 取工单与交期：排产模块把工单、交期、物料状态经网关给 ERP，ERP 回写真实约束，排产不再靠人工搬单。
• WMS 取批次与件级数据：追溯的批次、模穴、件级数据走网关开放给 WMS，正反向一键查，不锁死在私有表结构。
• 质量系统取 CTQ 与 SPC 结论：控制图判级、CTQ 结论经网关推给质量系统，判级自动闭环，不靠导出 Excel 再人工录。

四、选型建议

先确认要对接的系统清单，不要只看当前一两家，接口字典按最长名单定，避免后期加系统现扩字段。鉴权必须网关层收口，角色分级决定谁能取哪些端点，质量系统不该拿到配方下发权。限流按端点与角色配额，防止某个报表把底座读爆，这条不少项目上线后才暴露。版本管理要早定，接口带版本号向后兼容，旧系统不强制升级，新能力走新版本并行。高可用按现场定，单厂单线可省，多厂区建议网关冗余。部署跟随平台私有化，数据不出厂区优先。

五、交付与验收口径

交付时我们附一份《接口与字段字典》，把每个端点的协议、字段、鉴权、限流、版本列清，现场按表验收。网关上线检查项含四项：上层系统能按文档取到数、鉴权拦住越权端点、限流在压测下生效、接口调用在审计里可见。私有化部署给网关配置与巡检脚本，运维写进服务范围。验收不以「接口能调通一次」为准，以「压测下限流生效、越权被拦、调用可审计」四项为准。很多项目演示能通、一上量就崩，根子就是限流和压测没进验收。我们建议验收期故意越权一次、压测一次，把边界在签字前逼出问题。

六、实施与对接步骤

网关上线分四步，顺序错了返工多。第一步，建字段字典：把采集、SPC、参数库、排产、追溯的字段统一命名，屏蔽底层库差异，这是后面所有端点的基础。第二步，开端点：按业务先开 ERP/WMS 主干两条，跑通取数再横向扩质量、设备系统，别一上来全开。第三步，配鉴权限流：Token 与角色分级在网关层收口，限流配额按端点估，压测调到位。第四步，接审计：每次调用留痕，谁取了什么、哪个端点、什么时间可查。四步走完，上层系统只跟网关打交道，底座不被外部读取冲垮。实施里最常漏的是第一步的字段字典：不少项目端点各自命名，加系统又对一遍字段，网关形同虚设。我们交付时把字典作为验收附件，新增系统按字典接、不重命名。

七、接口标准化实务

标准化不是把字段凑齐，是把命名、类型、单位、空值语义统一。注射压力统一用 MPa、周期用秒、模温用摄氏度，单位错配是上层系统最常见的算错根因。空值语义更要写清：采集断点返回空还是上一值，直接影响 ERP 排产判空。字段字典开放给对接方，新系统按字典接、不反向改底层。我们给客户的是一份可执行的字典，不是文档摆设：端点、字段、类型、单位、空值、版本逐项列出，对接方照接即可。字典清楚了，网关才是标准化执行点，不是又一层转表。不少项目网关能通但字段靠人工脑补，加系统照样重写，根子就是字典没真落地。

八、鉴权与限流边界

鉴权在网关层统一收口，不在业务模块各自校验，否则一个模块漏配就成越权口。角色分级决定端点可见性：工艺能取配方、质量能取 CTQ、WMS 只能取批次，跨级取数在网关被拦并留痕。限流按端点与角色配额，报表类端点配额高、写类端点配额低，防止批量读取拉垮底座写入。边界写进交付文档，审计范围含越权拦截记录，客户验厂拿得出依据。我们建议验收期故意越权一次，看网关是否真拦、是否真留痕，比一份静态接口页更有价值。边界清楚了，网关既开放又可控，不会因一个报表把采集冲垮。

九、对接 ERP 主干

ERP 是对接最频的系统，主干先跑通工单与交期双向。MES 经网关把工单状态、完成量、异常给 ERP，ERP 回写交期、物料可用，排产拿到真实约束而非拍脑排程。字段映射屏蔽两侧差异，ERP 侧看的是它熟悉的结构，底层时序库不暴露。版本管理在这里最值钱：ERP 大版本升级只动网关映射层，不碰底层。我们交付时把 ERP 主干端点作为优先级一，先通再扩，避免全系统一起上、一处错全停。主干稳了，WMS 与质量系统对接只是复制模式，加系统成本线性可控。

十、灰度与回滚机制

接口上线要走灰度，不一次性全量切。新端点先对一个小厂区或一个 SKU 开放，观察调用量、限流命中、审计完整性，无异常再横向扩。回滚按版本号走：新版本出问题切回上一版本，端点兼容保证旧系统不受影响。灰度不是拖慢，是给验收留缓冲，把字段错配、限流误杀在小火苗阶段灭掉。我们建议每个新端点带版本号上线，回滚只改路由不碰代码，运维交接单列签字。灰度清楚了，加系统不惊动生产，底座不被一次大改拖垮。

十一、上线节奏与验收

网关上线别一口铺满：先单厂单线跑通字段字典与 ERP 主干，再横向扩 WMS、质量、设备系统，最后扩厂区。节奏错在「先铺面再定标准」，结果每个系统一套字段，网关成了转表壳。验收按四项：端点真通（上层按文档取到数）、鉴权真分（越权被拦并留痕）、限流真生效（压测下不拉垮底座）、审计真可见（调用可查）。四项过才签，比看接口页能打开更管用。我们建议验收期故意越权一次、压测一次、断网一次，把边界在签字前逼出问题，不进生产期。运维交接单列签字，巡检脚本交现场 IT，网关才不会被悄悄降配。开放与可控并重的分工，是我们对集成只报基线改善的底气。

相关产品

• MES 平台模块 MES-PLAT — 网关是其对外接口层，随底座部署。
• 边缘采集网关 MES-EG — 底层数据经采集网关汇入，再由本接口网关对外开放。

实践经验

某厂经 MES-APIG 接 ERP/WMS/质量三系统，新增一个 WMS 厂商仅 3 天接完端点，未改底层（按现场对接节点计）。

常见问题

网关和平台什么关系

网关是平台的对外接口层，统一收口鉴权限流，上层系统只跟网关打交道不碰底层库。

开放 API 会拖垮底座吗

不会，限流按端点与角色配额，异常拉取在网关层被拦，底座写入不被外部读取冲垮。

新增系统要重写对接吗

不用，新增系统只接已发布端点，字段字典屏蔽底层差异，加系统成本只是接端点。

接口版本怎么管

每个端点带版本号向后兼容，旧系统不强制升级，新能力走新版本并行，不破坏存量。