Anbindungen · Integration in eigene Systeme

API & Schnittstellen

Jeder Kunde bekommt Zugriff auf die API, um seine Ladeinfrastruktur in die eigenen Systeme zu integrieren: dokumentierte REST-API mit Swagger-Oberfläche und Webhooks, die Ereignisse direkt zustellen.

Beratungstermin vereinbaren

01 Zugriff

Kommen meine Daten in meine Systeme?

Ja — über eine Schnittstelle, die jeder Kunde bekommt und die im Produkt selbst dokumentiert ist. Ladepunkte, Ladevorgänge, Abrechnungsdatensätze und Statuswechsel lassen sich damit in eigene oder fremde Systeme übernehmen.

Wer nicht auf einen Abruf warten will, lässt sich Ereignisse direkt zustellen: Ladevorgang gestartet, Ladevorgang beendet oder ein Statuswechsel am Ladepunkt — als Webhook, signiert, damit die Herkunft der Nachricht geprüft werden kann.

02 Dokumentation

Dokumentiert, wie Entwickler es erwarten

Die Schnittstelle ist als OpenAPI-Dokument beschrieben und im Produkt als Swagger-Oberfläche abrufbar: jeder Endpunkt mit Parametern, Antworten und Beispielen, direkt aus dem Browser ausprobierbar. Wer die Ladeinfrastruktur in ein eigenes System holen will, findet dort alles an einem Ort — Ladepunkte, Status, Fernbefehle, Ladevorgänge, Abrechnungsdatensätze, Standorte, Ladekarten, Schlüssel und Webhooks.

Bildschirmaufnahme der Swagger-Oberfläche der ChargeCore-API: fünfzehn eingeklappte Gruppen untereinander, jede mit Kurzbeschreibung — Chargers, Charger Status, Commands, Configuration, Messages, Sessions, CDRs, Locations, Organization Units, Token Groups, Token Group Tokens, Roaming Tokens, API Keys, Webhooks und Products. — Die Gruppen der Schnittstelle in der Swagger-Oberfläche: vom Ladepunkt über Fernbefehle, Ladevorgänge und Abrechnungsdatensätze bis zu Schlüsseln und Webhooks — jede Gruppe klappt zu ihren Endpunkten auf.

Bildschirmaufnahme der Swagger-Oberfläche: die Gruppe Sessions mit dem aufgeklappten Endpunkt GET /sessions. Unter „Parameters“ die Abfrageparameter cursor, limit (Vorgabe 25), status, chargerId und search mit Beschreibung und Eingabefeld, rechts der Knopf „Try it out“. Unter „Responses“ die Antwort 200 „Cursor-paginated list of sessions“ als JSON-Beispiel mit den Feldern id, transactionId, chargerId, connectorId, idTag, startTimestamp, stopTimestamp, meterStart, meterStop, stopReason, status und nextCursor. — Ein Endpunkt im Detail: Ladevorgänge abrufen — Filter nach Status und Ladepunkt, seitenweise über einen Cursor, die Antwort als JSON-Beispiel mit jedem Feld. „Try it out“ schickt die Anfrage direkt aus der Dokumentation.

Bildschirmaufnahme der Swagger-Oberfläche: die Gruppe Webhooks mit fünf Endpunkten — GET /webhooks (List all webhooks), POST /webhooks (Create a webhook), GET /webhooks/{id}, PUT /webhooks/{id} und DELETE /webhooks/{id}; jede Zeile trägt das Schloss-Symbol für die erforderliche Anmeldung. — Webhooks werden über dieselbe Schnittstelle angelegt, geändert und gelöscht — die Zustellung an das eigene System richtet der Kunde selbst ein, ohne Zuruf an den Anbieter.

Den Zugang zur Dokumentation und den ersten Schlüssel gibt es mit dem Kundenzugang — die Dokumentation selbst ist Teil des Produkts und nicht frei im Netz verlinkt.

03 Zugang

Wer bekommt Zugang zur Schnittstelle?

Jeder Kunde. Auf Wunsch bekommt er einen API-Schlüssel für seine eigenen Daten — Ladepunkte, Ladevorgänge, Standorte und Abrechnungsdatensätze seiner Organisation — und bindet damit an, was er anbinden will: Abrechnung, Flottenverwaltung, Gebäudeleittechnik oder das eigene Kundenportal.

Was der Schlüssel öffnet, zeigt die Dokumentation oben. Was am Ladepunkt selbst passiert — Status, Fernbefehle, Diagnose — steht bei Ladepunkte fernsteuern und überwachen.

04 Meldung

Welche Meldungen laufen automatisch mit?

Zwei Pflichten, die über die eigene Schnittstelle hinausgehen — eine läuft von selbst, die andere übernehmen wir für Sie.

DATEX II läuft automatisch — Verkehrs- und Ladepunktdaten werden im DATEX-II-Format automatisch übertragen — ohne Zutun des Betreibers.
Meldung an die Bundesnetzagentur übernehmen wir — Wir reichen alle Ladepunkte unserer Kunden mit ihren Kenndaten bei der Bundesnetzagentur ein. Dafür registriert sich jeder Kunde einmalig selbst bei der Bundesnetzagentur und wählt dort die Eulektro GmbH als Dienstleister aus — ab dann läuft die Meldepflicht im Betrieb mit.

Nächster Schritt

Verbinden Sie ChargeCore mit Ihren Systemen.

Im Termin klären wir, welche Ereignisse Sie brauchen und wie der Zugang für Ihr Team aussieht.

Beratungstermin vereinbaren unterstützte Standards