概述

所属系统

本文档为 物联聚合 平台对外开放的 MQTT 接口规范。

物联聚合 OpenAPI 是一套高度标准化的 MQTT 接口规范，致力于构建物联聚合平台与第三方应用系统间高效、安全、可靠的数据交换通道。该规范充分利用 MQTT 协议的轻量级、低延迟特性，为设备全生命周期管理提供实时数据获取、精准状态监控及毫秒级事件通知等核心能力，全面支撑企业级设备管理、大数据分析与业务系统无缝集成，加速智能化物联应用的构建与落地。

物联聚合 OpenAPI 创新性地采用"查询+推送"双模架构设计：通过主动查询满足按需数据获取，借助实时推送确保关键事件的即时触达，二者协同工作，既保证了系统资源的高效利用，又实现了关键业务场景下零延迟的事件响应机制，为物联网应用提供坚实的通信基础。

基本信息

项目	说明
协议	MQTT
数据格式	JSON
字符编码	UTF-8

说明

本文档是 MQTT 协议规范，HTTP 接口规范请参阅 HTTP 协议文档。

在接口设计上，HTTP 协议因其直观的请求-响应模式，通常展现出更高的实用性和易用性，尤其适用于平台对外开放接口场景，调用过程简单直观。

相比之下，MQTT 协议的交互模式要求客户端先发布请求消息，再异步监听平台响应，这种双向通信机制虽灵活但实现复杂度较高。

因此，MQTT 更适合以下特定场景：

• 企业级防火墙穿透环境：在严格网络隔离的企业环境中，MQTT 可有效规避多端口开放策略限制，实现跨安全域的安全通信。

混合使用建议

如果觉得 MQTT 协议的交互模式过于繁琐，可以 HTTP 与 MQTT 混合使用：

• 查询接口 → 使用 HTTP
• 配置管理 → 使用 HTTP
• 推送功能 → 使用 MQTT（也可以 HTTP，MQTT 主要应用于企业防火墙的特殊环境）

非企业防火墙限制等特殊情况，还是建议使用 HTTP 的方式。混合模式既满足了特殊环境的限制，又简化了第三方系统集成复杂度，为企业提供灵活、高效的物联聚合连接方案。