探索Postman与HiveMQ的MQTT集成
目录
- 探索Postman与HiveMQ的MQTT集成
- Postman对MQTT的支持
- 使用Postman进行MQTT通信
- 利用Postman通过API管理HiveMQ云代理
- 执行API调用
- 结论
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的支持将简化你的开发工作流程并加快上市时间。
回复