如何在 QNAP QIoT Suite Lite 使用歷史資料存取 API
最後修訂日期:
2018-03-07
本篇教學文章說明如何在 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 文件〕查看更多資訊。
如以下範例：
