Zewnętrzne API Monitoringu

Cel

Dla integratorów wymagających widoczności w czasie rzeczywistym, odpytywanie naszego Telemetry API wprowadza opóźnienia i dodatkowe obciążenie zarówno po stronie integratora, jak i po stronie SmartgridOne. Aby to rozwiązać, kontroler można skonfigurować do wysyłania telemetrii do wyznaczonego punktu końcowego, który jest dostarczany przez integratora. Ten „mechanizm webhook” umożliwia przesyłanie danych na żywo z niemal zerową latencją, omijając ograniczenia tradycyjnego odpytywania API.

Konfiguracja po raz pierwszy (Punkt startowy dla nowych użytkowników)

1. Sprawdź swoją sieć

Upewnij się, że Twój SmartgridOne Controller ma aktywne połączenie sieciowe.

2. Dodaj swoje urządzenia

Zaloguj się do interfejsu uruchamiania i upewnij się, że urządzenia zostały dodane do SmartgridOne Controller.

3. Skonfiguruj webhook poprzez 'zewnętrzne źródła danych'

4. Wprowadź parametry

1. URL i punkt końcowy API

2. Token autoryzacyjny bearer używany do zapytania API. Aby zapobiec użyciu skompromitowanego kontrolera do fałszowania danych z innych urządzeń, zdecydowanie zalecamy stosowanie unikalnych tokenów dla każdego kontrolera i powiązanie każdego tokenu z określoną lokalizacją w Twojej implementacji.

3. Częstotliwość wysyłania danych (w sekundach, domyślnie 60s)

4. Wybierz, które dane mają być wysyłane:

   • Dane na poziomie urządzenia zawierają wszystkie opisane poniżej pola danych, dla każdego indywidualnego węzła podłączonego do SmartgridOne Controller.
   • Dane na poziomie typu urządzenia zawierają zebrane dane na poziomie typu urządzenia (np. solar, magazyn energii, stały)

Następnie wybierz, aby uwzględnić wszystkie urządzenia.

Dane punktu końcowego

Punkt końcowy powinien akceptować HTTP POST request z następującymi danymi:

Jeśli wybrano poziom typu urządzenia:

{
    "time": "<Unix Timestamp>",
    "siteNodeId": "<Site NodeID>",
    "grid": "<Grid Fields>",
    "solar": "<Solar Fields>",
    "storage": "<Storage Fields>",
    "heat_pump": "<Heat Pump Fields>",
    "switched_load": "<Switched Load Fields>",
    "variable_power_load": "<Variable Power Load Fields>"

Jeśli wybrano poziom urządzenia:

{
    "time": "<Unix Timestamp>",
    "siteNodeId": "<Site NodeID>",
    "nodeId1": "<Node Fields>",
    "nodeId2": "<Node Fields>",
    ...
}

Więcej informacji o poszczególnych polach można znaleźć tutaj: .