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.
Zorg ervoor dat uw SmartgridOne Controller een actieve netwerkverbinding heeft.
Log in op de inbedrijfstellingsinterface en zorg ervoor dat de apparaten zijn toegevoegd aan de SmartgridOne Controller.
De URL en het endpoint van de API
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.
De frequentie waarmee data wordt gepusht (in seconden, standaard is 60s)
Selecteer welke data moet worden gepusht:
Kies daarna om alle apparaten op te nemen.
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.