物联网平台数据接口怎么对接业务系统

> 北向接口对接，分主动推送(实时)、主动拉取(查询/历史)两大类，工业项目一般组合使用，禁止直接读IoT平台数据库。

一、4种主流接口对接方案

1. Webhook(HTTPS推送，中小流量实时)

IoT平台规则引擎，过滤、清洗设备遥测、告警、设备上下线事件，POST推送到业务系统开放接口。

- 流程：设备上报 → IoT平台规则引擎过滤/转换JSON → POST到业务系统API地址

- 鉴权：Header携带Token、签名校验;业务系统返回200代表接收成功，平台自动重试

- ✅优点：配置简单、开发量小;适合水务、照明、小型产线告警推送

- ❌缺点：高并发下业务系统容易压垮，重试会产生重复消息，必须做幂等去重

2. 服务端订阅 MQTT / AMQP(高并发工业实时首选)

业务系统作为MQTT客户端，长连接订阅IoT平台北向Topic，持续消费设备消息;可搭配Kafka/RocketMQ做消息缓冲。

- ✅优点：断线续传、消息ACK确认、支持QoS，百万测点不丢数;支持双向(下发控制指令给设备)

- ❌缺点：业务侧需要开发消费客户端，运维成本高

- 适用：工厂MES、电力、海量传感器、高可靠工业场景

3. RESTful开放API(业务系统主动拉取，历史+设备档案)

业务系统定时调用IoT平台HTTPS接口，按需查询，不是实时推送

接口分类：

- 实时接口：查询设备当前最新属性、在线状态

- 历史时序接口：按设备ID+起止时间，分页拉取历史遥测数据

- 设备档案接口：设备列表、标签、分组、产品信息

- ✅优点：主动权在业务系统，可断点续拉，适合报表、日归档、BI

- ❌缺点：轮询有延迟，高频调用会触发平台限流

4. WebSocket(大屏、监控平台，轻量实时)

长连接，平台主动推送设备状态变化;适合监控大屏、后台实时看板，不适合海量设备高并发场景

> 补充：OPC UA，工厂场景对接SCADA、MES常用，偏工业总线侧，属于边缘北向对接

二、完整落地对接步骤

1. 需求与字段定义

确定对接数据：遥测值、告警、设备生命周期;约定JSON结构、时间戳(UTC优先)、单位;区分实时流和历史归档。

2. 开通平台应用凭证

在IoT平台创建应用，获取 `AccessKey/SecretKey` 或Token，分配数据权限(按产品/设备分组隔离)。

3. 网络打通

- 公网：全部HTTPS/TLS加密，IP白名单;

- 企业内网：VPC、专线、VPN，不暴露公网端口。

4. 接口方案开发

- 推送方案：业务系统开发接收接口，做好消息ID幂等、日志、异常告警;

- 拉取方案：业务系统写定时任务，分页+增量时间戳拉取，避免重复。

5. IoT平台侧配置

新建规则引擎，设置Topic过滤、字段转换脚本，配置转发目标地址与鉴权。

6. 联调测试

单设备模拟上报、断网重试、压力测试、重复消息测试，校验数据完整性。

7. 上线运维

监控消息量、失败率、接口延迟;设置失败告警、消息堆积告警。

三、核心风险点(对接最容易踩坑)

1. 消息重复：平台重试机制会重复推送，业务系统必须用messageId做幂等，避免重复入库

2. 超时堆积：Webhook业务接口响应慢，平台消息堆积，建议高并发改用MQTT+消息队列解耦

3. 鉴权过期：Token定时刷新机制要处理，防止接口突然鉴权失败

4. 时区问题：时间戳不统一会造成历史数据错乱，统一UTC时间

5. 限流：REST API大量拉历史数据，必须分页+限速，防止被平台封禁

四、聚英物联网平台接口对接要点

1. 标准云服务：智能终端设备标配聚英物联网平台进行远程数据监控，支持通过监控中心大屏显示，手机APP实时移动监控，可实现农业、工业自动化、环境监测、水利水电、智慧工地、畜禽养殖、水产养殖等场景一体化监控，监控平台标题可用户自定义设置。

2. API接口开发：使用聚英物联网平台提供的API接口，用户根据自己的业务应用需求开发前端软件比如小程序，app，WEB平台，PC端软件等，服务器端与智能终端设备的通讯交互，服务器运维由聚英云农完成，可以减少二次开发过程种80%的工作量和难度。

3. 私有化部署：平台私有化，将聚英物联网平台部署到用户自己的私有服务器上，完全由企业独立自主管理，进行商业化应用。