REST API

Home Assistant-API

Nu in gebruik bij Home Assistant-installaties. Hij loopt via het EdgeTech-platform en vraagt dus een abonnement; zonder abonnement, zie lokaal aansturen.

Het adres is https://<server>/ev/api/v1/<gebruikers-id>/<locatie-id>, gevolgd door een actie. De MyCharger-app geeft de server, je gebruikers-ID en je locatie-ID, en een kant-en-klare configuratie voor Home Assistant: MyCharger > Instellingen > Expert > REST API.

Actie	Aanroep	Wat het doet
Status, alle laadpunten	?action=status	Status van elk laadpunt op de locatie
Status, één laadpunt	?action=status&socket=<laadpunt-id>	Status van één laadpunt
Starten	?action=start&socket=<laadpunt-id>	Laden toestaan op dat laadpunt
Stoppen	?action=stop&socket=<laadpunt-id>	Laden stoppen en blokkeren op dat laadpunt
1 fase	?action=phase&phases=1	Laden op één fase, voor de hele locatie
3 fasen	?action=phase&phases=3	Laden op drie fasen, voor de hele locatie

GET en POST werken allebei. Maximaal 10 aanroepen per minuut per adres; vraag de status elke 30 seconden of minder vaak op.

Antwoord

{"response": {"success": true, "API-version": "1.0", "message": "...",
  "data": {"site": "<locatie-id>", "sockets": [{"id": "<laadpunt-id>", "name": "Oprit",
    "properties": {"cable_connected": "1", "cable_max_current": "32", "car_connected": "1", "charging": "1",
      "current_1": "15.9", "current_2": "16.0", "current_3": "15.8", "charger_board_temperature": "31",
      "session_kwh": "7.4", "last_session_kwh": "21.3", "allow_charging": "true"}}]}}}

Eigenschap	Betekenis
cable_connected, car_connected, charging	1 of 0
cable_max_current	Wat de kabel toestaat, A
current_1, current_2, current_3	Laadstroom per fase, A
charger_board_temperature	Temperatuur van de laadmodule, °C
session_kwh, last_session_kwh	Energie van de huidige en de vorige sessie, kWh
allow_charging	Of laden is toegestaan (starten / stoppen)

Een waarde die de laadpaal nog niet heeft doorgegeven is unknown. Gaat er iets mis, dan is success false en zegt message waarom.

Voorbeeld voor Home Assistant

rest:
  - resource: "https://<server>/ev/api/v1/<gebruikers-id>/<locatie-id>?action=status&socket=<laadpunt-id>"
    scan_interval: 30
    sensor:
      - name: "Laadstroom L1"
        unit_of_measurement: "A"
        device_class: current
        value_template: "{{ value_json.response.data.sockets[0].properties.current_1 }}"
      - name: "Energie laadsessie"
        unit_of_measurement: "kWh"
        device_class: energy
        value_template: "{{ value_json.response.data.sockets[0].properties.session_kwh }}"
    binary_sensor:
      - name: "Auto aangesloten"
        value_template: "{{ value_json.response.data.sockets[0].properties.car_connected == '1' }}"

rest_command:
  laadpaal_start:
    url: "https://<server>/ev/api/v1/<gebruikers-id>/<locatie-id>?action=start&socket=<laadpunt-id>"
    method: post
  laadpaal_stop:
    url: "https://<server>/ev/api/v1/<gebruikers-id>/<locatie-id>?action=stop&socket=<laadpunt-id>"
    method: post

De configuratie uit de app bevat ook een dashboard.

Houd je gebruikers-ID voor jezelf

Het gebruikers-ID in het adres geeft toegang tot je laadpalen, net als je app. Deel het niet en zet het niet in screenshots. Is het toch gedeeld, vraag support om een nieuw.

Bredere API

Binnenkort: een API voor derden met een eigen token per locatie, alleen-lezen of lezen en schrijven, en een OpenAPI-bestand.

Gebied	Aanroepen
Locaties en laadpunten	locaties tonen, locatie-info, locatiestatus, laadpunten, status van een laadpunt, configuratie van laadpunt en locatie
Aansturing	laden toestaan of weigeren, nu starten, uitgestelde start, schema-items, plug and charge, prioriteit per laadpunt, fasen per laadpunt
Limieten	maximale locatiestroom, type netaansluiting
Zon	zonnemodus, alleen laden met zonnestroom, uitgebreide trigger en voorwaarde
Inzicht	verbruiksrapport per periode, instelling energieprijs, statusverversing forceren
Support	diagnoseticket, log uploaden, firmware controleren en upgraden

Liever lokaal

Geen cloud, geen abonnement: stuur de laadmodule rechtstreeks aan via Modbus RTU (registeroverzicht), met evcc of de Modbus-integratie van Home Assistant. Eén master per bus.