De P1 meter beschikt over een lokale API om data op te vragen die op dat moment gemeten wordt. Je kunt deze API benaderen zolang je verbonden bent met hetzelfde (Wi-Fi) netwerk als de P1 meter. Deze API is bedoeld om je P1 meter aan een eigen automatisering, domotica of grafieken systeem te koppelen. Het is niet mogelijk om data geschiedenis op te halen met de lokale API.


Voorwaarden

1. Licentie:
De HomeWizard P1 meter API wordt in licentie gegeven, niet verkocht. HomeWizard verleent de gebruiker een niet-exclusieve licentie (zonder recht op sublicentie) om slechts één exemplaar van de HomeWizard P1 meter API te gebruiken voor persoonlijk, niet-commercieel gebruik.
2. Gebruik: De gebruiker mag niet direct of indirect de HomeWizard P1 meter API gebruiken om een product, systeem of software te verkopen, leasen, uitlenen of inkomsten te genereren.
3. Support:
Het gebruik van de P1 meter API wordt officieel ondersteund door HomeWizard, maar HomeWizard kan geen klantenservice leveren met betrekking tot de implementatie van de API in uw eigen of applicaties van derden.


Type aanvraag

De P1 meter ondersteunt 2 methodes om data op te opvragen. Je kunt de data gestructureerd als JSON opvragen onder data of je kan de ruwe data vanuit de slimme meter opvragen onder telegram.De API biedt toegang tot de meest recente update die is aangeboden door de slimme meter. 


Frequentie van gegevensupdate

De snelheid hiervan is afhankelijk van de SMR versie van jouw slimme meter. Bij SMR 5.0 is dit elke seconde voor stroom en elke 5 minuten voor gas. Bij lager dan SMR 5.0 is dit elke 10 seconden voor stroom en elke 60 minuten voor gas. Je vindt de SMR versie van jouw slimme meter op je slimme meter of via de API. Er is geen limiet op het aantal requests op de lokale API, echter adviseren wij om niet vaker data op te halen dan elke 500ms.


Data opvragen van de P1 meter

Met deze HTTP GET data request kun je de data opvragen van een P1 meter.


http://{IP address}/api/v1/data


In bovenstaande request dient bij {IP address} het lokale IP adres ingevuld te worden van de P1 meter waar je data van wilt opvragen. Vervolgens krijg je de onderstaande waardes terug in JSON.

Voorbeeld van een P1 meter data response


HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 476

{
    "smr_version": 50, 
    "meter_model": "ISKRA  2M550T-101",
    "wifi_ssid": "My Wi-Fi",
    "wifi_strength": 100,
    "total_power_import_t1_kwh": 10830.511,
    "total_power_import_t2_kwh": 2948.827,
    "total_power_export_t1_kwh": 1285.951,
    "total_power_export_t2_kwh": 2876.514,
    "active_power_w": -543,
    "active_power_l1_w": -676,
    "active_power_l2_w": 133,
    "active_power_l3_w": 0,
    "total_gas_m3": 2569.646,
    "gas_timestamp": 210606140010
}



smr_version: [Number] De SMR versie van de meter
meter_model: [String] Het merk en type indicatie van de slimme meter
wifi_ssid: [String] Het Wi-Fi netwerk waarmee de P1 meter is verbonden
wifi_strength: [Number] De sterkte van het Wi-Fi signaal in %
total_power_import_t1_kwh: [Number] De stroom afname meterstand voor tarief 1 in kWh
total_power_import_t2_kwh: [Number] De stroom afname meterstand voor tarief 2 in kWh
total_power_export_t1_kwh: [Number] De stroom teruglevering meterstand voor tarief 1 in kWh
total_power_export_t2_kwh: [Number] De stroom teruglevering meterstand voor tarief 2 in kWh
active_power_w: [Number] Het huidig gebruik van alle fases gecombineerd in Watt
active_power_l1_w: [Number] Het huidig gebruik voor fase 1 in Watt (indien van toepassing)
active_power_l2_w: [Number] Het huidig gebruik voor fase 2 in Watt (indien van toepassing)
active_power_l3_w: [Number] Het huidig gebruik voor fase 3 in Watt (indien van toepassing)
total_gas_m3: [Number] De gas meterstand in m3
gas_timestamp: [Number] De datum en tijd van de meest recente gas meterstand gestructureerd als YYMMDDhhmmss.



Ruwe data opvragen van de slimme meter (telegram)

Met de API is de meest recente telegram van de slimme meter op te vragen. Deze ruwe data wordt verzonden zonder aanpassingen door de P1 meter.


LET OP! 
Het opvragen van een telegram is op dit moment tijdelijk niet ondersteund


http://{IP address}/api/v1/telegram


In bovenstaande request dient bij {IP address} het lokale IP adres ingevuld te worden van de P1 meter waar je data van wilt opvragen. Vervolgens krijg je via de P1 meter de ruwe telegram van de slimme meter terug.

Onderstaand een voorbeeld van een telegram response. Hoe je deze data moet interpreteren vind je in de officiële P1 companion standaard van Netbeheer Nederland.


/ISK5\\\\2M550T-10111-

3:0.2.8(50)
0-0:1.0.0(181106140429W)
0-0:96.1.1(31333631353032362020202020202020)
1-0:1.8.1(10830.511*kWh)
1-0:1.8.2(002948.827*kWh)
1-0:2.8.1(001285.951*kWh)
1-0:2.8.2(002876.514*kWh)
0-0:96.14.0(0002)
1-0:1.7.0(21.100*kW)
1-0:2.7.0(00.000*kW)
0-0:96.7.21(00006)
0-0:96.7.9(00003)
1-0:99.97.0(1)(0-0:96.7.19)(180529135630S)(0000002451*s)
1-0:32.32.0(00003)
1-0:52.32.0(00002)
1-0:72.32.0(00002)
1-0:32.36.0(00001)
1-0:52.36.0(00001)
1-0:72.36.0(00001)
0-0:96.13.0()
1-0:32.7.0(236.0*V)
1-0:52.7.0(232.6*V)
1-0:72.7.0(235.1*V)
1-0:31.7.0(002*A)
1-0:51.7.0(000*A)
1-0:71.7.0(000*A)
1-0:21.7.0(00.000*kW)
1-0:41.7.0(00.033*kW)
1-0:61.7.0(00.132*kW)
1-0:22.7.0(00.676*kW)
1-0:42.7.0(00.000*kW)
1-0:62.7.0(00.000*kW)
0-1:24.1.0(003)
0-1:96.1.0(4730303339303031373030343630313137)
0-1:24.2.1(210606140010W)(02569.646*m3)
!1F28