本篇教學文章說明如何在 QNAP QIoT Suite Lite 使用歷史資料存取 API。 使用歷史資料存取 API 時,您必須在 QIoT 建立物體並確認資料輸入類型為數字(int、float),才能正確輸出 count、sum、vmin、vmax 及 vavg 類型的資料。

此外,如果您的資料來自 Node-RED(如 TCP、UDP、HTTP 及 MQTT 節點),您必須將其變更為適用的 QIoT 物體, 如下圖所示。

接收歷史資料的方式有兩種:
1. 使用 Node-RED QHistoricData 節點
2. 使用 RESTful API

1. 使用 NodeRed QHistoricData 節點

輸入節點代表「觸發」,而輸出節點代表「取得歷史資料」。 節點可協助使用者從 QIoT Suite Lite 資料庫取得歷史資料。 使用者可以設定〔解析度〕、〔間隔〕和〔範圍〕等選項。 根據所選項目,API 會從「IoT 物體」和「資源」傳回歷史資料。

  • 名稱: 自定義的節點名稱
  • 物體: 可選擇的物體
  • 資源: 所選資源的歷史資料
  • 解析度: 選擇分鐘、天或小時
  • 間隔: 資料的間隔。 其取決於解析度和範圍。
  • 範圍: 輸出資料的範圍。 其取決於解析度。
  • API 金鑰: 您必須建立 API 金鑰以備使用。 若要設定 API 金鑰,請前往〔設定〕>〔API 金鑰〕

如以下範例(傳回的格式為「JSON」):

{
 "result": [
 {
 "totalCount":  1,
 "data":  [
 {
 "count":  6347,
 "vmin":  1,
 "sum":  316959,
 "vmax":  100,
 "_id":  "2018-01-18T08:43:56",
 "vavg":  49.93839609264219
 }
 ]
 }
 ]
 }

2. 使用 RESTful API

前往 QIoT Suite Lite 頁面並點擊右上角的 ,然後選擇〔API 文件〕查看更多資訊。


如以下範例:

文章標籤
創作者介紹
創作者 tttt 的頭像
tttt

Anderson 四處逛逛

tttt 發表在 痞客邦 留言(0) 人氣()