Externe Monitoring API

Doel

Voor integratoren die realtime zichtbaarheid vereisen, veroorzaakt het opvragen via onze Telemetrie API vertragingen en extra belasting 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 endpoint dat door de integrator wordt geleverd. Dit 'webhook-mechanisme' maakt live datastromen met bijna nul latency mogelijk, waarmee de beperkingen van traditionele API-polling worden omzeild.

Eerste configuratie (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 endpoint 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 wij sterk aan om unieke tokens per controller te gebruiken en elke token te koppelen aan een specifieke locatie in uw implementatie.

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

4. Selecteer 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)

Kies daarna om alle apparaten op te nemen.

Endpoint Data

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

Als apparaat type niveau is geselecteerd:

{
    "time": "<Unix Timestamp>",
    "siteNodeId": "<Site NodeID>",
    "grid": "<Grid Velden>",
    "solar": "<Solar Velden>",
    "storage": "<Storage Velden>",
    "heat_pump": "<Warmtepomp Velden>",
    "switched_load": "<Geschakelde Belastings Velden>",
    "variable_power_load": "<Variabele Vermogensbelasting Velden>",
}

Als apparaatniveau is geselecteerd:

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

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