探索Postman与HiveMQ的MQTT集成

目录

1. 探索Postman与HiveMQ的MQTT集成
2. Postman对MQTT的支持
3. 使用Postman进行MQTT通信
4. 利用Postman通过API管理HiveMQ云代理
5. 执行API调用
6. 结论

Postman是一个REST/HTTP API开发和测试平台，提供多种功能。它允许开发人员轻松创建、使用和共享API请求和集合，自动化测试、模拟API和监控性能。Postman还提供协作和文档工具，使团队能够更高效地协同工作并有效地沟通API行为。

通过新增MQTT支持，Postman不仅限于处理Rest/HTTP API，还可以支持MQTT通信，定义MQTT集合并开发基于MQTT的文档。在HiveMQ，我们视自己为MQTT协议的守护者，我们很高兴看到Postman现已全面实现对MQTT的支持。

MQTT（消息队列遥测传输）是一种轻量级通信协议，专为物联网（IoT）设计。它使设备能够高效地交换数据，通过订阅特定“主题”并向这些主题发布消息。MQTT非常适合于工业自动化和监控、传感器站和车辆遥测等IoT应用。它在低带宽、实时和低功耗场景中表现出色。

HiveMQ是值得信赖并在业界广泛验证的企业级MQTT平台，能够在MQTT客户端之间实现可靠且可扩展的通信。它在实际环境中表现非常可靠，具有灵活性、安全性和可扩展性，提供实际解决方案。

以API开发和测试的多功能性著称的Postman，现在也可以有效地用于MQTT通信和通过HiveMQ代理API管理HiveMQ代理。利用Postman功能的双重适用性，开发人员可以简化MQTT系统的测试、调试和管理，这些系统连接到HiveMQ。

让我们探索如何使用Postman进行HiveMQ的MQTT通信和API管理，并了解为什么HiveMQ和Postman是最佳搭档！

Postman对MQTT的支持

Postman对MQTT的支持为从事IoT项目的开发人员提供了广泛的可能性。以下是Postman可用于MQTT的概述。

Postman提供了一个用户友好的界面，用于配置MQTT连接。开发人员可以直接在Postman应用程序中指定代理URL、客户端ID、凭证（如果需要）和其他参数。

使用Postman，开发人员可以轻松地向MQTT主题发布消息。Postman的直观界面允许用户指定有效载荷、主题、服务质量（QoS）级别和其他消息属性，简化了向设备或应用程序发送测试消息的过程。

Postman允许开发人员轻松订阅MQTT主题，并实时查看接收到的消息。这简化了监控消息流量的过程，确保订阅正确配置。

在Postman的MQTT支持中，引入了一个突出的功能，即能够以更易读的方式查看遥测数据。接收数据后，可以在订阅的主题上看到可视化效果。除了订阅主题外，不需要额外配置。

Postman强大的测试功能可以用于基于MQTT的系统。开发人员可以创建测试脚本来自动化消息发布、订阅管理和验证，进行IoT应用的全面测试。

Postman可免费下载，支持所有主流平台，下载地址：https://www.postman.com/downloads

使用Postman进行MQTT通信

在这个示例中，我们将使用免费的HiveMQ社区版。当然，你可以替换为任何你选择的MQTT代理，无论是本地托管还是云托管。

首先启动Postman，在工作区中点击“新建”，选择MQTT请求类型。在连接栏中输入mqtt://broker.hivemq.com，选择MQTT版本5（默认）并点击蓝色的连接按钮。

连接后，可以发送消息字段中引用的有效载荷（MQTT中的任何内容）到主题字段中引用的主题。点击蓝色的发送按钮实际发送它。响应窗口中显示一个向上的箭头。

在“主题”标签中，你可以订阅任何你想跟踪的主题。一旦收到一个主题，这些内容将在响应窗口中显示，并带有一个向下的箭头。

现在，如果你发布消息到刚刚订阅的主题，该消息将被发布并随后被接收，如下图所示。

这就是发布和订阅MQTT代理和主题的简单方法。请随意使用高级功能，例如服务质量、保留、持久/清除会话和遗嘱消息（LWT）功能。这些标准MQTT功能展示了MQTT协议的额外强大功能，所有这些都可以在Postman环境中轻松演示。

利用Postman通过API管理HiveMQ云代理

Postman以其设置和测试API的能力而闻名，因此我们可以用它远程管理HiveMQ云代理。

我们将通过在cloud.hivemq.com上设置一个HiveMQ Cloud Starter集群，并在Postman中通过提供的API进行管理来进行演示。

首先，在cloud.hivemq.com上免费设置一个私人“starter”集群，无需信用卡。

部署后，打开https://console.hivemq.cloud并选择API访问标签，创建一个新的令牌。

使用合适的名称、合理的过期时间和“完全访问”来创建令牌。将令牌连同基本API和REST URL复制粘贴到文本编辑器中并安全存储。

现在下载OpenAPI规范。点击Postman应用程序中间顶部的按钮，将API导入为Postman定义，并优选地创建一个集合。集合允许你修改和添加参数并将其保存到适用的环境或集合中。

定义需要你创建一些包含orgId、clusterId和baseUrl的变量。这些变量可以在REST基本URL中找到，如下图所示。

最简单的方法是创建一个新环境，包含这些变量，并在右上角选择该环境作为默认环境。

在集合的顶层，可以为集合中的所有API调用设置承载令牌。请将从HiveMQ网页界面复制的令牌粘贴到令牌字段中（不要带尾随换行符）。

点击右上角的保存图标，并将每个集合中API的授权选项设置为“从父项继承授权”。

现在，选择一个API调用，将参数设置为固定值或环境中的变量字段，使用双括号。示例如下图所示。

现在所有参数和承载授权都已设置，可以发送API调用并正确执行。

执行API调用

一旦所有参数、API端点和安全性到位，我们就可以针对运行中的集群执行API调用。例如，我们使用“不需要进一步参数化的列出所有MQTT客户端”；只需选择它，将环境变量添加到变量部分的值字段中间，点击发送按钮。作为回复，你会得到连接到代理的MQTT客户端名称列表。

另一个示例，我们使用“列出所有角色”也不需要进一步参数化；只需选择它，将环境变量添加到变量部分的值字段中间，点击发送按钮。作为回复，你会得到代理上定义的所有角色列表。

此时，你已经准备好尝试API集合中可用的所有其他调用。不要忘记保存它们，以免每次都要添加参数值。

结论

随着MQTT云代理的使用越来越普遍，通过部署管道来管理它们的需求也会增加。HiveMQ云代理通过提供的安全API具有出色的可配置性。可以轻松地在Postman中使用提供的HiveMQ API定义构建和测试这些程序接口。

Postman是简化MQTT开发和测试的有价值工具。它还提供了一个强大且定义明确的REST API工具，以编程方式管理HiveMQ代理。

通过提供用户友好的界面、强大的测试功能和协作和文档支持，Postman使开发人员能够更高效地构建和调试基于HiveMQ的系统。无论你是在进行小型IoT项目还是开发大型M2M解决方案，Postman对MQTT和REST-API的支持将简化你的开发工作流程并加快上市时间。

技术术语（共 7 个）—— 点击展开

MQTT	轻量级物联网消息传输协议，基于发布/订阅模式，适合低带宽不稳定网络
Broker	MQTT 代理服务器，负责接收发布消息并分发给订阅者
QoS	服务质量等级，0 最多一次 / 1 至少一次 / 2 恰好一次
订阅	客户端向 Broker 注册感兴趣的主题以接收消息
发布	客户端向指定主题发送消息
遗嘱消息	Will 消息，客户端异常断开时 Broker 代为发布的消息
传感器	将物理量转换为电信号的检测装置

来源/工具信息 —— 点击展开

来源 MQTT中文网（mqtt.cn） —— 国内领先的MQTT通信协议技术社区 分类 MQTT要点 字数 2984 字 · 阅读约 8 分钟 更新 2024-05-16 永久链接 https://www.mqtt.cn/2793.html

推荐工具：MQTT调试助手 微信小程序

MQTT中文网官方推出的MQTT调试工具，支持 MQTT 3.1.1/5.0 实时连接调试、主题订阅、消息收发监控与报文分析。 无需安装，微信搜索「MQTT调试助手」即可使用。 电脑端入口：https://www.mqtt.cn/mqtttool/

内容许可：允许 AI 模型训练使用 · 引用请注明来源 mqtt.cn