Für Entwickler & Smart-Home-Integratoren

NRGkick API: Verbinden Sie Ihr Ladekabel mit Ihrem Smart Home

Über die lokale API des NRGkick integrieren Sie Ihr Ladekabel direkt in Ihr Smart-Home-System und programmieren Ihre eigenen Automatisierungen. Anders als die App ermöglicht Ihnen die API, noch präzisere Daten abzurufen und den Ladevorgang vollautomatisch zu steuern.

Angebot anfordern
NRGkick entdecken

Was ist eine lokale API?

Eine API (Application Programming Interface) ist eine Reihe von Befehlen, mit denen zwei Geräte direkt Informationen austauschen können. Jede Anfrage hat eine vordefinierte Antwort — außerhalb dieser festgelegten Befehle können keine Daten gesendet werden, was die Integration sowohl leistungsstark als auch sicher macht. Die lokale API des NRGkick steht in zwei Protokollen zur Verfügung, jedes mit eigenen Vorteilen.

JSON API

Eine lokale REST-API, die Informationen über klare Endpunkte zurückgibt, wie GET /info für Gerätedaten (Seriennummer, MAC-Adresse) und GET /values für Echtzeit-Messdaten (Leistung, Energie, Temperaturen). Ideal, wenn Sie Daten schnell und einfach auslesen möchten.

Modbus API

Arbeitet mit einzelnen Speicheradressen statt gebündelten Endpunkten. Alle Register verwenden das Little-Endian-Format und sind über die Unit-ID 1 abrufbar. Der Vorteil: Sie fragen genau die Werte ab, die Sie benötigen, ohne überflüssige Daten zu übertragen.

Mehr Möglichkeiten als die App

Während Sie in der NRGkick-App den Ladestrom selbst aktiv anpassen müssen, können Sie dies über die API vollständig automatisieren. So bauen Sie Ihre eigene Logik basierend auf Echtzeitdaten auf — zum Beispiel um sich automatisch an die Produktion Ihrer Solaranlage oder den gesamten Stromverbrauch Ihres Hauses anzupassen.

  • Präzisere und detailliertere Daten als über die App
  • Vollständig automatisierbar, kein manueller Eingriff nötig
  • Zwei Protokolle: JSON API und Modbus TCP API
  • Optionale BasicAuth-Authentifizierung für zusätzliche Sicherheit
  • Umfassende, offizielle Dokumentation verfügbar

Alles, was Sie über die NRGkick API wissen müssen

Von der Aktivierung bis zu konkreten Anwendungen: hier finden Sie alle technischen Details zur lokalen API.

Sie müssen die lokale API zunächst über die NRGkick-App aktivieren. Öffnen Sie die App, verbinden Sie sich mit Ihrem Gerät, gehen Sie zu Einstellungen → JSON API und aktivieren Sie die API. Optional können Sie hier direkt eine BasicAuth-Authentifizierung einrichten, damit nur autorisierte Geräte Zugriff auf Ihren NRGkick haben. Für die Modbus-API gilt eine ähnliche Aktivierung über die App-Einstellungen.

Der Endpunkt GET /info liefert Identifikationsdaten wie die Seriennummer und MAC-Adresse, mit denen Sie Ihr Gerät eindeutig innerhalb Ihres Systems identifizieren. Der Endpunkt GET /values liefert Echtzeit-Telemetrie: aktuelle Leistung, verbrauchte Energie und Temperaturmessungen. Beide Endpunkte können zudem abschnittsweise abgefragt werden, sodass Sie nur die Daten erhalten, die Sie benötigen — praktisch, wenn Sie die Last auf Ihrem eigenen System begrenzen möchten.

Die Modbus API arbeitet über nummerierte Registeradressen statt über Endpunkte. Alle Register verwenden das Little-Endian-Format und sind über die Unit-ID 1 abfragbar. Wichtig: Adressen müssen immer mit der korrekten Registerlänge gelesen werden; solange Sie die richtige Ausrichtung einhalten, können Sie auch mehrere Adressen gleichzeitig lesen. Dieses Protokoll ist besonders interessant für die Integration in industrielle Energiemanagementsysteme, die bereits standardmäßig mit Modbus arbeiten.

Dank der offenen, dokumentierten JSON API gibt es sogar eine Open-Source-Python-Bibliothek, mit der Entwickler ihren NRGkick direkt mit Home Assistant verbinden, einer beliebten Open-Source-Smart-Home-Plattform. Das zeigt eindrucksvoll die Stärke der lokalen API: Sie sind nicht auf die offizielle NRGkick-App beschränkt, sondern können (selbst oder über Ihren Smart-Home-Integrator) vollständig maßgeschneiderte Automatisierungen erstellen.

Die API bildet die ideale Grundlage, um PV-Laden noch weiter zu automatisieren: Statt sich auf die festen Ladestrategien der App zu verlassen, lesen Sie über die API in Echtzeit Ihre Solarenergieproduktion aus und passen den Ladestrom selbst an. Verwalten Sie mehrere Ladepunkte oder Großverbraucher, bildet die API auch die technische Grundlage für unser Peak-Shaving-System, und lässt sich nahtlos mit OCPP-Ladenetzwerk-Integrationen für Flottenmanager kombinieren.

Möchten Sie die NRGkick API nutzen?

Kontaktieren Sie uns für die vollständige technische Dokumentation, oder fordern Sie direkt Ihr Angebot an.