反向控制

1. 功能概述

在仪表板中可以通过调用外部API命令，发送消息给设备端或服务端，实现对设备的反向控制。

2. 外部API

2.1 添加外部API

2.1.1 在仪表板的属性设置中找到外部API，点击“添加项目”，打开外部API对话框

用户在同一个仪表板中可以添加多个外部API，为了区分这些外部API, 您可以根据API功能进行命名。
API 类型有3种，MQTT, HTTP, WebSocket, 您可根据实际需求选择API类型。
选择不同的API类型，下面的属性略有不同，根据实际情况填写即可。
所有必填信息填写完成后，用户可以点击测试连接验证是否连接成功。

2.1.2 外部API 添加完成后，可在外部API 列表中查看，编辑，删除

2.2 调用外部API

外部API 添加完成，需要通过命令调用API。目前支持调用外部API命令的组件有图片、按钮、拓扑图。接下来，以拓扑图为例，介绍通过命令调用外部API。

2.2.1 添加任意拓扑图到页面，在拓扑图的属性设置中找到鼠标左键选项，选择命令，然后添加命令。接着在命令下拉菜单中选择调用外部API。

2.2.2 外部API 选择 MQTT 或者WebSocket 类型的外部API, 在数据框中填写需要发送的数据即可。通过点击数据框中的插入列表字段图标，可以将绑定到拓扑图的字段或者仪表板参数插入数据传递给MQTT或者WebSocket。

2.2.3 外部API 选择HTTP类型的外部API，用户也可以增加多个查询参数，查询参数值还可以使用绑定的字段值。

2.2.4 保存仪表板，预览仪表板，点击该拓扑图，即可实现调用外部API命令发送消息或数据给设备或服务器。

3. 场景一：调用外部API关闭故障设备

上一节我们学习了如何通过物联网数据构建拓扑图应用，当某个设备发生故障时，我们希望可以通过仪表板发送API请求给设备从而关闭设备或者调节阈值。

3.1 实现方式

3.1.1 设备“1#空压机”订阅控制主题（如factory/compressor_01/cmd），服务器向该主题发布消息。通过调用外部API，模拟服务器向设备发送消息。以上一节“通过物联网数据构建拓扑图应用”为例，编辑上一节附件中的仪表板，添加外部API, API类型可以选择MQTT, 填写您的服务器地址，填写设备订阅的控制主题。