Controleer veilig vanuit uw eigen systeem.
Voer vlak voor een nieuwe inboeking één EVSE-ID- of EAN-controle uit. Laadregister geeft direct een technisch signaal terug, zonder gegevens van andere inboekdienstverleners te delen.
Maak een organisatiecredential aan
- Log in op Mijn portaal en kies uw organisatie.
- Open Organisatiebeheer en daarna API-integraties.
- Maak als organisatiebeheerder een API-sleutel aan en bewaar die direct in de beveiligde opslag van uw serveromgeving.
Bewaar credentials nooit in browsercode, een mobiele app of een repository. De volledige waarde is slechts eenmaal zichtbaar. U kunt een credential direct intrekken of van een verloopdatum voorzien.
Registreer een laadpaal voor uw klant
Een organisatiecredential kan naast controles ook een laadpaal voor een klant aanmelden. Nieuwe API-registraties krijgen de status ingediend en worden daarna in het portaal beheerd of gevalideerd.
POST https://www.laadregister.nl/api/v1/registrations
Authorization: ******
Idempotency-Key: 2a9f2a9a-b4d3-4c89-9b76-9d0e8d0c2a11
Content-Type: application/json
{
"evse_id": "NL*ABC*E1234567",
"ean": "8712345678910",
"operator": "Voorbeeld Exploitatie"
}| Onderdeel | Waarde | Toelichting |
|---|---|---|
| Methode | POST | Alleen POST wordt ondersteund. |
| Pad | /api/v1/registrations | Registreert één laadpaal voor de organisatie van de credential. |
evse_id | string | Technische EVSE-identificatie. |
ean | string | EAN-/aansluitingsnummer. |
operator | string | Naam van de operator. |
Een technische identificatie mag maar één keer in het register voorkomen. Bij een retry gebruikt u exact dezelfde Idempotency-Key en dezelfde gegevens.
Meerdere laadpalen tegelijk registreren
Gebruik POST /api/v1/registrations/bulk voor maximaal 500 laadpalen per aanvraag. De hele batch wordt als één geheel verwerkt: bij een fout wordt geen enkele registratie opgeslagen. Gebruik voor een nieuwe batch een nieuwe idempotency key.
POST https://www.laadregister.nl/api/v1/registrations/bulk
Authorization: ******
Idempotency-Key: 6b2f8d6e-5f91-4b1d-9c9d-0e9d55b6d7aa
Content-Type: application/json
{
"registrations": [
{
"evse_id": "NL*ABC*E1234567",
"ean": "8712345678910",
"operator": "Voorbeeld Exploitatie"
},
{
"evse_id": "NL*ABC*E1234568",
"ean": "8712345678927",
"operator": "Voorbeeld Exploitatie"
}
]
}Een registratie controleren
Gebruik een organisatiecredential voor een server-naar-serverkoppeling. De organisatie volgt uit de credential; stuur daarom geen organisatie-ID of klantgegevens mee. Bij registratie leggen we EVSE-ID en EAN vast; voor iedere controle stuurt u één van beide nummers mee.
POST https://www.laadregister.nl/api/v1/checks
Authorization: ******
Idempotency-Key: 7f5c8261-6e37-4e17-9040-4f420cb21702
Content-Type: application/json
{
"identifier": "NL*ABC*E1234567"
}| Onderdeel | Waarde | Toelichting |
|---|---|---|
| Methode | POST | Alleen POST wordt ondersteund. |
| Pad | /api/v1/checks | Gebruik altijd dit actuele endpoint. |
| Authorization | ****** | Gebruik de organisatiecredential als Bearer-token. |
| Idempotency-Key | UUID v4 | Verplicht en uniek per nieuwe inboeking. |
| identifier | string | Een EVSE-ID of EAN-/aansluitingsnummer. |
Veilig opnieuw proberen
Herhaal een technisch mislukte aanvraag met precies dezelfde Idempotency-Key. Maak alleen een nieuwe sleutel voor een nieuwe controle. Zo voorkomt u dubbele dossiers of dubbel uitgevoerde controles.
Verwerk het signaal, niet de beslissing
Een antwoord met match: false betekent dat geen bestaande registratie is gevonden. Uw organisatie houdt zelf de verantwoordelijkheid voor de uiteindelijke inboeking.
{
"check_id": "b5bf18c5-bc89-459f-a9e3-1aa456f895e7",
"match": false,
"ownership": "none",
"message": "Geen registratie gevonden; u kunt doorgaan.",
"duplicate_case_id": null
}Bij ownership: "own" is het nummer al door uw eigen organisatie geregistreerd. Bij ownership: "other" is een mogelijke dubbelregistratie gevonden. De bestaande inboekdienstverlener ontvangt dan een afgeschermd dossier om dit te beoordelen.
{
"check_id": "b5bf18c5-bc89-459f-a9e3-1aa456f895e7",
"match": true,
"ownership": "other",
"message": "Mogelijke dubbelregistratie gevonden. De bestaande partij is geïnformeerd.",
"duplicate_case_id": "d5a045fa-ff8d-46d0-87fa-b86bb8151e02"
}| Veld | Betekenis |
|---|---|
check_id | Unieke identificatie van deze controle. |
match | true bij een bestaande registratie, anders false. |
ownership | none, own of other. |
message | Leesbare toelichting voor uw log of gebruikersinterface. |
duplicate_case_id | Dossier-ID bij een mogelijke registratie van een andere organisatie; anders null. |
Reageer voorspelbaar op fouten
{
"error": "Authenticatie en een geldige idempotency key zijn verplicht."
}| Status | Betekenis | Actie |
|---|---|---|
200 | De controle is uitgevoerd. | Verwerk het antwoord. |
400 | Header, JSON of identifier is ongeldig. | Corrigeer de invoer en stuur de aanvraag opnieuw met een nieuwe idempotency-key. |
401 | Credential is onbekend, verlopen of ingetrokken. | Controleer de serverconfiguratie of maak een nieuwe credential aan. |
403 | De sessie heeft geen toegang tot de gekozen organisatie. | Gebruik voor koppelingen een organisatiecredential. |
500 | De controle kon niet veilig worden afgerond. | Probeer later opnieuw met dezelfde idempotency-key. |
503 | De dienst is tijdelijk niet beschikbaar. | Probeer later opnieuw met dezelfde idempotency-key. |
Richt de koppeling beheersbaar in
Gebruik de API als onderdeel van uw bestaande inboekproces, niet als vervanging van uw eigen beoordeling. Start met een beperkte, gecontroleerde inrichting voordat u de koppeling breed inzet.
- Maak per koppeling een API-sleutel aan en bewaar die uitsluitend in de beveiligde opslag van uw serveromgeving.
- Stuur voor iedere nieuwe inboeking precies één EVSE-ID of EAN en hergebruik dezelfde idempotency-key bij een technische retry.
- Leg de
check_id, uitkomst en eigen vervolgstap in uw proces vast, zodat uw organisatie de controle kan herleiden.
Heeft u vragen over de technische inrichting of deelname aan de pilot? Gebruik dan het contactformulier.