Laadpaal API koppelingen

API-ontwerp en datamodellering

Een stabiele koppeling begint met expliciete mapping: welke velden zijn leidend, welke eenheden gebruik je en hoe ga je om met ontbrekende waarden. Zonder dit ontwerp krijg je later inconsistentie tussen dashboards en rapportages.

Voor SEO-vragen rond laadpaal API is dit de kern: niet elk endpoint is direct bruikbaar zonder normalisatie. Goede integraties voegen daarom een vertaal- en validatielaag toe.

Security en toegangsbeheer

Gebruik minimaal tokenrotatie, beperkte scopes en veilige secret-opslag. API-sleutels hardcoderen in clients is een klassiek risico. Ook in hobbyomgevingen is dat op termijn een incidentwachtkamer.

Beperk bovendien write-acties waar mogelijk. Voor de meeste dashboards en analyses is read-only toegang voldoende en veiliger.

Rate limits, caching en performance

Respecteer rate limits en gebruik caching waar data niet realtime hoeft te zijn. Onnodig agressief pollen verhoogt kans op throttling en maakt je integratie instabiel op drukke momenten.

Voor Core Web Vitals is dit indirect ook relevant: een rustige, voorspelbare dataflow voorkomt zware client-side fallbacklogica in je UI.

Monitoring en foutdetectie

Log requestduur, errorcodes en dataveroudering. Een koppeling die technisch 'up' is maar uren oude data levert, is functioneel nog steeds problematisch. Definieer daarom SLA-achtige drempels voor dataversheid.

Koppel deze signalen aan alerts zodat je afwijkingen ziet voordat gebruikers verkeerde conclusies trekken uit dashboards.

Integreren met Home Assistant en workflows

Maak onderscheid tussen business-sensors (opbrengst, kWh) en technische sensors (API-latency, update-age). Die splitsing maakt dashboards rustiger en automatiseringen betrouwbaarder.

Gebruik scenario-tests na API-updates. Daarmee voorkom je dat een kleine veldwijziging onzichtbaar meerdere automations breekt.

Endpoints en Home Assistant configuratie

GET /chargers geeft de status van je laadpalen: live meterwaarden, of er een sessie actief is (is_charging) en of de laadpaal MID-gecertificeerd en ERE-geschikt is (mid_certified, mid_eligible). Loopt er een sessie, dan bevat current_session ook kwh_so_far en het id_tag van die sessie. GET /sessions levert je recente sessies (gepagineerd), met onder meer kwh, status, counts_for_ere en ere_credits per sessie, handig om een sessie te spotten die niet meetelt voor ERE. GET /energy geeft kant-en-klare maandtotalen (total_kwh, total_ere_credits, total_sessions) zodat je zelf niets hoeft te aggregeren voor een maandgrafiek. GET /ere-position is het interessantste endpoint voor de euro-kant: total_expected_eur (verwachte jaaropbrengst), reserved.net_eur en paid.net_eur (al verkocht/uitbetaald), unsold.ere en unsold.forecast_net_eur (nog onverkochte credits en hun verwachte waarde) en indicative_price_per_ere (actuele marktprijs).

Kopieer onderstaande YAML naar je Home Assistant configuration.yaml (of een package) om Joulo-sensoren toe te voegen. Authenticatie verloopt via de Authorization-header met een bearer-token.

Bewaar je token in secrets.yaml, nooit als platte tekst in een bestand dat je deelt of publiceert. Test eerst met een los curl-commando en controleer de responsvelden voordat je de sensoren in productie gebruikt: zo voorkom je dat dashboards op onvolledige velden of verkeerde unit-conversies draaien.

curl -sS "https://api.joulo.nl/functions/v1/api/chargers" -H "Authorization: Bearer <jouw-api-token>"

curl -sS "https://api.joulo.nl/functions/v1/api/sessions" -H "Authorization: Bearer <jouw-api-token>"

curl -sS "https://api.joulo.nl/functions/v1/api/energy" -H "Authorization: Bearer <jouw-api-token>"

curl -sS "https://api.joulo.nl/functions/v1/api/ere-position" -H "Authorization: Bearer <jouw-api-token>"

rest:
  - resource: "https://api.joulo.nl/functions/v1/api/chargers"
    method: GET
    headers:
      Authorization: !secret joulo_api_token
    scan_interval: 300
    sensor:
      - name: "Joulo Laadstatus"
        value_template: "{{ value_json.chargers[0].status }}"
      - name: "Joulo Is Aan Het Laden"
        value_template: "{{ value_json.chargers[0].is_charging }}"
      - name: "Joulo Sessie kWh"
        value_template: "{{ value_json.chargers[0].current_session.kwh_so_far | default(0) }}"
        unit_of_measurement: "kWh"

  - resource: "https://api.joulo.nl/functions/v1/api/energy"
    method: GET
    headers:
      Authorization: !secret joulo_api_token
    scan_interval: 3600
    sensor:
      - name: "Joulo Totaal kWh"
        value_template: "{{ value_json.total_kwh }}"
        unit_of_measurement: "kWh"
        state_class: total_increasing
      - name: "Joulo Totaal ERE"
        value_template: "{{ value_json.total_ere_credits }}"
        state_class: total_increasing

  - resource: "https://api.joulo.nl/functions/v1/api/ere-position"
    method: GET
    headers:
      Authorization: !secret joulo_api_token
    scan_interval: 3600
    sensor:
      - name: "Joulo Verwachte Jaaropbrengst"
        value_template: "{{ value_json.total_expected_eur }}"
        unit_of_measurement: "EUR"
      - name: "Joulo Onverkochte ERE"
        value_template: "{{ value_json.unsold.ere }}"
      - name: "Joulo Onverkochte Verwachte Opbrengst"
        value_template: "{{ value_json.unsold.forecast_net_eur }}"
        unit_of_measurement: "EUR"
      - name: "Joulo ERE Prijs"
        value_template: "{{ value_json.indicative_price_per_ere }}"
        unit_of_measurement: "EUR"

Implementatiechecklist voor productie

Een stabiele EV-dataset ontstaat niet vanzelf. Werk met een vaste checklist per wijziging: controleer protocolstatus, valideer meetwaarden, vergelijk met historische trend en log alle aanpassingen in firmware of backendconfiguratie. Deze werkwijze voorkomt dat regressies onzichtbaar blijven en maakt troubleshooting sneller wanneer cijfers afwijken. Voor teams die data delen met meerdere stakeholders is deze discipline essentieel om discussies op feiten te voeren.

Voeg daarnaast operationele monitors toe die niet alleen errors tonen, maar ook stilte detecteren. Een keten kan technisch online zijn terwijl sessies urenlang niet worden bijgewerkt. Meet daarom dataversheid, updatefrequentie en consistentie tussen verschillende bronnen. Deze signalen geven vaak eerder problemen aan dan handmatige controle in dashboards.

Plan periodieke validaties met vaste KPIs: sessievolledigheid, ratio afgekeurde metingen, afwijking tussen bron A en B, en tijd tot herstel na een incident. Door deze KPIs maandelijks te herhalen ontstaat een objectief beeld van kwaliteit. Dat helpt bij platformkeuzes, contractbesprekingen en technische prioritering.

Bronvalidatie en transparantie

Informatie rond ERE, thuisladen vergoeding en marktprijzen verandert door regelgeving, verificatieprocessen en handel. Behandel openbare cijfers daarom als momentopname en leg in je eigen documentatie vast welke aannames je gebruikt. Zo blijven analyses reproduceerbaar en voorkom je dat oude aannames ongemerkt in nieuwe beslissingen doorwerken.

Gebruik meerdere bronnen wanneer je keuzes maakt over inboekdienstverleners, protocolarchitectuur of meetinrichting. Let op details zoals lock-inmoment, vereiste documentatie, uitbetalingscyclus en controleproces van de dienstverlener. In de praktijk zijn dit de factoren die bepalen of een technisch goede setup ook operationeel en financieel betrouwbaar blijft.

Veelgestelde vragen

Lees ook