获取空开状态数据
控制器是一种用于控制、管理和监测电流的设备,在电路中控制电流的开关,实现电路的启动、停止和切换。该类型设备通过Wi-Fi或以太网方式接入平台,用于控制开关状态,获取设备实时状态、电路电流等信息,并将其数据传输到NAYOTA平台上进行分析和处理。本文以空气开关(空开)为例,介绍通过 NAYOTA API 接口,如何获取控制器的最新数据和历史数据。
步骤如下:
前置条件:生成token凭证,设置环境变量
::: highlight gray
点击此处,进入生成token凭证教程
注:如果已经设置环境变量,直接进入下面步骤
:::
步骤一:获取空开最新数据
::: highlight
方法①:通过空开名称查询
- 点击此处,进入查询空开信息页面
- 点击按钮,打开右侧在线运行窗口,在Query参数下输入:
- 点击"发送"按钮,发送接口请求
方法②:通过空开id查询
- 点击此处,进入通过id查询空开信息页面
- 点击按钮,打开右侧在线运行窗口,在Path参数下输入:
- 点击"发送"按钮,发送接口请求
- 返回数据如下 -
{
"line": false, // 最新记录的在线状态
"value": 1, // 最新记录的状态值
"valueStr": "开启",
"_id": "601372e3bce064001cdf96a8", // 空开id
"name": "机柜电源",
"interval": "[[\"开启\",\"关闭\"],[1,0]]", // 对应关系,状态值为 1 是"开启",为 0 是"关闭"
"valueAt": "2023-01-18T17:02:53.422Z", // 最新记录的上报时间
... ...
}
:::
步骤二:根据id获取空开历史数据
::: highlight
- 点击此处,进入查询空开历史数据页面
- 点击"调试"按钮,打开右侧在线运行窗口,在Query参数下输入:
注:check为空开id,可通过步骤一获取
- 点击"发送"按钮,发送接口请求
- 返回数据如下 -
{
"_id": "63c8263d5a3ba96eb98db049", // 查询的记录id,记录为多条,此处仅展示两条
"operate": {
"line": true, // 在线状态
"value": 1, // 记录的状态值
"valueStr": "开启",
"_id": "601372e3bce064001cdf96a8", // 空开id
"name": "机柜电源",
"interval": "[[\"开启\",\"关闭\"],[1,0]]", // 对应关系,状态值为 1 是"开启",为 0 是"关闭"
"recordTime": "2023-01-18T17:02:53.422Z", // 该条记录生成的时间
... ...
},
},
{
"_id": "63c825b45a3ba9685f8c918d",
"operate": {
"line": true,
"value": 1,
"valueStr": "开启",
"_id": "601372e3bce064001cdf96a8",
"name": "机柜电源",
"interval": "[[\"开启\",\"关闭\"],[1,0]]",
"recordTime": "2023-01-18T17:00:36.053Z",
... ...
},
}
:::
查看更多 API 请前往 NAYOTA 开放平台
修改于 1 年前