API di Monitoraggio Esterno

Obiettivo

Per gli integratori che necessitano di visibilità in tempo reale, l'interrogazione a polling della nostra Telemetry API introduce ritardi e comporta un overhead sia per l'integratore sia per SmartgridOne. Per risolvere questo, il controller può essere configurato per inviare la telemetria a un endpoint designato fornito dall'integratore. Questo "meccanismo webhook" permette flussi di dati in diretta con latenza quasi nulla, superando le limitazioni del tradizionale polling API.

Configurazione Iniziale (Punto di partenza per nuovi utenti)

1. Verifica la tua rete

Assicurati che il tuo SmartgridOne Controller abbia una connessione di rete attiva.

2. Aggiungi i tuoi dispositivi

Effettua il login all'interfaccia di messa in servizio e assicurati che i dispositivi siano aggiunti al SmartgridOne Controller.

3. Configura il webhook tramite 'fonti dati esterne'

4. Inserisci i parametri

1. L'URL e l'endpoint dell'API

2. Il token di autorizzazione bearer utilizzato per la richiesta API. Per evitare che un controller compromesso possa essere utilizzato per falsificare dati da altri dispositivi, raccomandiamo fortemente di utilizzare token unici per ciascun controller e di vincolare ogni token a una specifica ubicazione nella tua implementazione.

3. La frequenza con cui i dati vengono inviati (in secondi, il valore predefinito è 60s)

4. Seleziona quali dati devono essere inviati:

   • I dati a livello di dispositivo contengono tutti i campi dati specificati di seguito, per ogni singolo nodo collegato al SmartgridOne Controller.
   • I dati a livello di tipo dispositivo contengono dati aggregati per tipo dispositivo (ad esempio solare, storage, fisso)

Successivamente, seleziona per includere tutti i dispositivi.

Dati dell'Endpoint

L'endpoint deve accettare una richiesta HTTP POST con i seguenti dati:

{
    "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>"

Ulteriori informazioni sui singoli campi sono disponibili qui: .