Externe Monitorings-API

Doel

Voor integratoren die realtime zichtbaarheid vereisen, introduceert het polleren van onze Telemetrie-API vertragingen en brengt het overhead met zich mee, zowel aan de kant van de integrator als aan de kant van SmartgridOne.
Om dit op te lossen, kan de controller worden geconfigureerd om telemetrie te verzenden naar een aangewezen eindpunt dat door de integrator wordt verstrekt.
Deze 'webhook-mechanisme' maakt live datastromen mogelijk met bijna nul latency, waarmee de beperkingen van traditionele API-polling worden omzeild.

Configuratie voor de eerste keer (Startpunt voor nieuwe gebruikers)

1. Controleer uw netwerk

Zorg ervoor dat uw SmartgridOne Controller een actieve netwerkverbinding heeft.

2. Voeg uw apparaten toe

Log in op de inbedrijfstellingsinterface en zorg ervoor dat de apparaten zijn toegevoegd aan de SmartgridOne Controller.

3. Configureer de webhook via 'externe databronnen'

4. Voer de parameters in

1. De URL en het eindpunt van de API

2. De bearer autorisatietoken die wordt gebruikt voor het API-verzoek. Om te voorkomen dat een gecompromitteerde controller wordt gebruikt om data van andere apparaten te vervalsen, raden we sterk aan om unieke tokens per controller te gebruiken en elk token te koppelen aan een specifieke locatie in uw implementatie.

3. De frequentie waarmee data wordt gepusht (in seconden, standaard is 60s)

4. Kies welke data moet worden gepusht:

   • Apparaatniveau-data bevat alle hieronder gespecificeerde datavelden, per individueel knooppunt verbonden met de SmartgridOne Controller.
   • Apparaattype-niveau bevat geaggregeerde data op apparaattype-niveau (bijv. zonne-energie, opslag, vast)

Selecteer daarna om alle apparaten op te nemen.

Endpoint-gegevens

Het eindpunt moet een HTTP POST-verzoek accepteren met de volgende data:

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

Meer informatie over de individuele velden is hier te vinden: Feedback Payload Structure.