开放天车PHM预测性维护API接口，与30家MES厂商完成数据对接

天车的预测性健康管理（PHM）系统积累的设备运行数据只有与车间的制造执行系统（MES）和上层管理平台打通，才能从孤立的告警工具升级为融入生产调度决策的数据枢纽。近日克鲁德重工正式开放天车PHM预测性维护系统的RESTful API接口，截至发稿时已与30家MES厂商完成数据对接联调，覆盖冶金MES、离散制造MES和仓储WMS三大主流系统类型。API开放后，天车的实时状态数据、告警事件和维保建议可直接推送至客户已有的生产管理平台中，无需操作员在多个系统之间切换查询。本文从API技术规范、对接流程、典型应用场景和联调效果四个维度进行系统介绍。

一、PHM API接口体系与数据模型

本次开放的PHM API遵循OpenAPI 3.0规范，采用RESTful架构风格，数据格式支持JSON和Protocol Buffers两种序列化方式。API按资源类型分为五大类接口，覆盖天车PHM系统的全部核心数据能力。

设备实时状态接口（Realtime Status API）：提供天车当前运行状态的一键查询。主要端点包括：GET /api/v1/crane/{craneId}/status（返回当前运行参数——大车位置X/Y坐标、起升高度、运行速度、电机电流、制动器状态、超载限制器读数等共计36个字段，刷新频率为1秒）、GET /api/v1/crane/{craneId}/health（返回设备健康评分，基于多维度参数融合计算的0~100分的设备健康指数，健康评分每5分钟更新一次）和GET /api/v1/crane/{craneId}/alerts（返回当前未处理的告警列表，支持按严重等级和告警类型筛选）。

历史数据接口（History API）：提供设备运行数据和告警历史的批量查询。端点包括：GET /api/v1/crane/{craneId}/timeseries（按时间范围查询指定参数的历史时序数据，最大支持30天的连续数据导出，采样周期可配置为1秒/10秒/1分钟三档）、GET /api/v1/crane/{craneId}/alerts/history（查询历史告警事件列表，含告警产生时间、消除时间、告警类型、严重等级和处理状态）和GET /api/v1/crane/{craneId}/maintenance（查询设备维保记录，含维保类型、维保时间、维保内容和执行人员）。历史数据接口主要用于MES系统生成设备OEE分析报表和维保计划排程。

告警推送接口（Alert Webhook API）：支持MES平台以Webhook方式订阅PHM系统的告警事件。客户在PHM Web后台配置告警推送规则（指定推送的URL、告警等级阈值和推送频率），当PHM系统产生新的告警事件时，自动向配置的Webhook URL发送POST请求，请求体为JSON格式的告警事件数据。Webhook支持重试机制——首次推送失败后间隔30秒重试，最多重试3次，三次均失败则切换为邮件通知管理员手动处理。Webhook推送延迟中位数为5秒（从PHM检测到异常到客户MES收到推送消息）。

设备管理接口（Device Management API）：提供天车设备基础信息的CRUD操作。端支持添加新设备（POST /api/v1/crane，自动生成设备唯一标识和初始配置参数）、更新设备配置（PATCH /api/v1/crane/{craneId}，修改告警阈值、采样频率等参数）、查询设备列表（GET /api/v1/cranes，支持按车间、设备类型和运行状态筛选）和设备删除（DELETE /api/v1/crane/{craneId}，需二次确认）。设备管理接口使客户的MES系统可以在新增天车时自动完成PHM系统的设备注册，无需人工登录PHM后台操作。

模型与诊断接口（Model API）：提供AI诊断模型的管理和诊断结果查询。端点包括：GET /api/v1/model/{modelId}/info（查询指定诊断模型的信息——模型版本号、部署时间、支持的天车型号和精度指标）、POST /api/v1/crane/{craneId}/diagnose（对指定天车触发一次即时健康诊断，返回各子系统的健康状态和推荐维保措施）和GET /api/v1/crane/{craneId}/diagnose/history（查询历史诊断报告的列表）。Model API使客户的MES调度系统可以在排产前主动查询天车健康状态，避免将生产任务分配给健康状态不佳的设备。

二、API对接技术方案与安全认证

PHM API采用OAuth 2.0客户端凭证模式（Client Credentials Grant）进行身份认证。客户MES系统在首次对接时，通过PHM开发者平台申请客户端ID（client_id）和客户端密钥（client_secret），然后通过POST /oauth/token端点获取访问令牌（access_token），令牌有效期默认24小时，过期后需使用refresh_token刷新。API的请求频率限制为：实时状态接口每小时最多查询6000次（即平均每秒约1.67次），历史数据接口每小时最多360次，告警推送和模型诊断接口无频率限制。接口响应时间在99%分位下小于500ms（不含慢速网络传输）。

数据传输采用TLS 1.3加密，API网关部署于阿里云API Gateway，支持WAF（Web应用防火墙）和DDoS防护。API请求日志记录所有调用的时间戳、客户端ID、请求路径、响应状态码和响应时长，日志保留周期为180天，客户可通过开发者平台自助查询API调用统计（日调用量、成功率、平均响应时间等指标）。平台提供API沙箱环境（sandbox），客户可在沙箱中使用模拟数据完成接口开发和调试，确认无误后切换至生产环境。沙箱环境与生产环境的数据完全隔离，不会影响真实设备数据。

三、对接进度与MES厂商覆盖

截至发稿时已与30家MES厂商完成API联调对接，覆盖冶金行业（12家）、重型装备制造（8家）、机械加工（6家）和仓储物流（4家）四个行业领域。对接的MES系统类型包括：国产主流MES（如用友U8+MES、金蝶云星空MES、鼎捷MES等——14家）、垂直行业MES（如冶金MES、铝加工MES、船舶MES等——10家）和自研MES（大型企业自研的车间管理系统——6家）。

对接过程中各MES厂商集成PHM数据的常见使用模式有三种：告警看板集成（MES系统的设备监控看板中嵌入PHM告警列表，操作员无需切换到PHM系统即可查看天车的健康告警——约70%的客户选择）、维保工单自动生成（MES系统接收到PHM告警后用其自动触发维保工单创建流程，工单中自动填入设备信息、告警描述和推荐维保方案——约45%的客户选择）和设备健康与排程联动（MES排程模块在分配吊运任务时自动查询PHM设备健康评分，将紧急任务优先分配给健康评分高的天车——约20%的客户选择）。三种模式可以组合使用，互不冲突。

联调测试的平均周期为3~5个工作日（从MES厂商获取API文档到完成端到端数据验证），最快的1家MES厂商在2个工作日内完成对接。联调阶段发现的典型问题包括：API请求频率超出限制（通过调整MES系统的轮询间隔解决，建议实时状态接口的轮询周期不低于5秒）、数据同步时序问题（PHM告警时间与MES工单时间的时区不匹配——通过在告警数据中同时返回UTC时间和本地时间解决）和Webhook接收端证书过期（通过接入API Gateway的证书有效性自动监控和提前30天预警解决）。

四、典型应用场景与效果数据

以一家已接入PHM API的冶金企业为例，该企业拥有5台天车，上线前天车的告警信息需要设备管理员登录PHM Webb后台人工查看，发现告警后手动填写纸质维保工单送交维修班组，从告警产生到工单下达的平均耗时为45分钟。API对接后，PHM系统的告警事件通过Webhook自动推送至该企业的MES系统，MES系统根据告警等级自动生成维保工单（Warning级工单自动分配给白班维修组，Critical级工单即时通知值班工程师），工单生成时间缩短至10秒以内。接入后6个月的统计数据显示，该企业的天车非计划停机的平均响应时间（从故障发生到维修人员到达现场）从85分钟缩短至22分钟，非计划停机造成的产能损失降低约62%。

API接口的开放也为PHM系统的持续优化提供了数据基础——天车健康评分预警模型利用MES系统反馈的维保结果数据（故障是否确实由PHM告警对应、实际更换的零部件型号和维保用时）进行迭代训练，使预警准确率每季度提升约1.5个百分点。下一阶段计划开放的数据接口包括：天车能耗数据（大车/小车/起升电机的实时电耗和累计能耗，支持能耗对标和节能优化）和吊运作业统计（每台天车的日均吊运次数、吊运重量分布和作业时长统计，支持生产调度效率分析），计划在年底前完成与50家MES厂商的对接。

常见问题（FAQ）

Q1：PHM API的调用是否会产生额外费用？免费额度是多少？

克鲁德重工克鲁德重工PHM API作为天车远程运维平台的增值功能，对已订阅远程运维服务的客户免费开放。API调用量包含在平台的年服务费中，不单独计费。免费调用额度为：每台天车每天10万次API调用（含所有接口，实时状态和历史数据接口合计），超出部分将按每万次10元计费。根据已对接客户的实测数据，单台天车在不同使用模式下的日均API调用量分别为：仅看板集成模式约500~3000次/天，看板+维保工单模式约3000~8000次/天，看板+维保工单+排程联动模式约8000~25000次/天。绝大多数客户的日均调用量在免费额度范围内。

Q2：API接口的可用性和服务质量有什么保障？

API服务SLA承诺：月度可用性不低于99.5%（以阿里云API Gateway的可用性统计为准），API平均响应时间不超过500ms（99%分位）。如月度可用性低于承诺标准，客户可申请当月服务费10%的补偿。API网关部署于阿里云华东2（上海）和华北2（北京）双可用区，支持跨可用区自动故障切换。平台每季度发布API更新日志，涉及接口参数变更的提前30天通知，确保客户MES系统有充足的适配时间。符合GB/T 36344-2018《信息技术 云计算 云服务运营通用要求》的相关条款。

Q3：MES厂商对接PHM API需要具备哪些技术能力？

对接方需要具备基础的RESTful API集成能力：支持HTTPS通信（TLS 1.2及以上）、OAuth 2.0客户端凭证认证模式、JSON数据格式的解析和处理。推荐的开发人员技能要求为：1名后端开发工程师（熟悉HTTP协议和JSON数据处理，约2~3个工作日完成接口接入开发）和1名系统实施工程师（负责与现场设备管理员确认告警阈值和推送策略配置，约1个工作日完成）。平台提供完善的API文档（含代码示例，支持Python/Java/C#三种语言的SDK）和技术支持微信群（工作日工作时间内响应时间<30分钟）。

Q4：PHM API的数据模型是否支持自定义扩展字段？

支持。每个API响应体中都预留了extensions（扩展字段）对象，类型为JSON Object，默认返回空值。客户可通过PHM Web后台上传到扩展字段的值（如客户的设备编号、车间名称、MES工单号等），扩展字段数据会随标准API响应一起返回。扩展字段最大支持20个键值对，每个键名不超过64字符，每个值不超过512字符。扩展字段配置即时生效，无需重启API服务。该功能的典型使用场景：客户将天车在其MES系统中的内部编码映射为扩展字段，实现双系统设备编码的自动匹配。