如何在 QNAP QIoT Suite Lite 使用歷史資料存取 API？ @ 觀察筆記

本篇教學文章說明如何在 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

 }

 ]

 }

 ]

 }