W tym samouczku dowiesz się, jak korzystać z API dostępu do danych historycznych w QNAP QIoT Suite Lite. Korzystając z API dostępu do danych historycznych, należy pamiętać o ograniczeniu polegającym na tym, że musisz utworzyć urządzenie (thing) w QIoT i potwierdzić, że typ danych wejściowych jest numeryczny (int, float) — dopiero wtedy API może zwracać wyniki w typach: count, sum, vmin, vmax i vavg.
Jeśli odbierane dane pochodzą z Node-RED (np. węzły TCP, UDP, HTTP i MQTT), musisz przekonwertować je na urządzenie (thing) z QIoT, aby mogły być używane. Jak pokazano na poniższym rysunku.
Istnieją dwa sposoby pobierania danych historycznych:
a. Przy użyciu węzła QHistoricData w Node-RED
b. Przy użyciu interfejsu API RESTful
Węzeł wejściowy oznacza „wyzwalacz", a węzeł wyjściowy oznacza „pobieranie danych historycznych". Węzeł pomaga użytkownikom pobierać dane historyczne z bazy danych QIoT Suite Lite. Użytkownicy mogą konfigurować opcje takie jak „Resolution" (Rozdzielczość), „Interval" (Interwał), „Range" (Zakres) i inne. W zależności od dokonanych wyborów API zwróci dane historyczne z „IoT Thing" i „Resources".
Na przykład (format zwracany będzie „JSON"):
Przejdź do strony QIoT Suite Lite, kliknij ikonę w prawym górnym rogu
i wybierz "API Documentation", aby uzyskać więcej informacji.
Na przykład:
Jeśli odbierane dane pochodzą z Node-RED (np. węzły TCP, UDP, HTTP i MQTT), musisz przekonwertować je na urządzenie (thing) z QIoT, aby mogły być używane. Jak pokazano na poniższym rysunku.
Istnieją dwa sposoby pobierania danych historycznych:
a. Przy użyciu węzła QHistoricData w Node-RED
b. Przy użyciu interfejsu API RESTful
a. Korzystanie z węzła QHistoricData w Node-RED
Węzeł wejściowy oznacza „wyzwalacz", a węzeł wyjściowy oznacza „pobieranie danych historycznych". Węzeł pomaga użytkownikom pobierać dane historyczne z bazy danych QIoT Suite Lite. Użytkownicy mogą konfigurować opcje takie jak „Resolution" (Rozdzielczość), „Interval" (Interwał), „Range" (Zakres) i inne. W zależności od dokonanych wyborów API zwróci dane historyczne z „IoT Thing" i „Resources".
- Name: Własna nazwa węzła
- Thing: Urządzenie (thing) do wybrania
- Resources: Dane historyczne wybranego zasobu (Resource)
- Resolution: Wybór minuty, dnia lub godziny
- Interval: Interwał danych. Zależy od ustawień Resolution i Range
- Range: Zakres danych wyjściowych. Zależy od ustawienia Resolution
- API Key: Wymagane jest utworzenie klucza API. Aby skonfigurować klucz API, przejdź do „Settings" > „API Keys"
Na przykład (format zwracany będzie „JSON"):
Kod:
{
"result": [
{
"totalCount": 1,
"data": [
{
"count": 6347,
"vmin": 1,
"sum": 316959,
"vmax": 100,
"_id": "2018-01-18T08:43:56",
"vavg": 49.93839609264219
}
]
}
]
}b. Korzystanie z interfejsu API RESTful
Przejdź do strony QIoT Suite Lite, kliknij ikonę w prawym górnym rogu
i wybierz "API Documentation", aby uzyskać więcej informacji.
Na przykład: