觀察筆記

本篇教學文章說明如何在 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 文件〕查看更多資訊。

如以下範例：