如何在 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
                }
            ]
        }
    ]
}

2. 使用 RESTful API

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

如以下範例：