# REST API

De Home Assistant-API: status per laadpunt, starten, stoppen en wisselen tussen laden op 1 en 3 fasen, over HTTPS via het EdgeTech-platform, met een abonnement. Met een voorbeeldconfiguratie voor Home Assistant. Een bredere API voor derden met eigen tokens komt binnenkort.

Canonical: https://edgetech.eu/nl/docs/rest-api  
Bijgewerkt: 2026-10-20

## 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](#liever-lokaal).

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

```json
{"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

```yaml
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](mailto:support@edgetech.eu) 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](/nl/docs/modbus-registers)), met evcc of de Modbus-integratie van Home Assistant. Eén master per bus.