Mit der Plugchoice REST API baust du dein eigenes Produkt auf der Plattform auf: Ladestationen, Sessions und Zählerwerte auslesen, Ladevorgänge starten und stoppen, Karten, Standorte und Energiemanagement verwalten und mehr. Diese Seite ist die Kurzfassung für Partner; die vollständige technische Dokumentation findest du auf developer.plugchoice.com.
Wo die Dokumentation liegt
developer.plugchoice.com: die vollständige API-Referenz sowie Anleitungen zu Authentifizierung, Fehlern, Paginierung und Rate Limiting.
Baust du mit einem KI-Assistenten? Gib ihm developer.plugchoice.com/llms.txt (der Index) oder llms-full.txt (die gesamte Dokumentation in einer Datei). Dein KI-Coding-Tool kann dann Fragen zur API beantworten und die Integration für dich schreiben.
Zwei Wege zur Authentifizierung
Personal access token: der schnellste Einstieg. Erstelle eines unter Einstellungen > Personal Access Tokens im Plugchoice Dashboard, dann kannst du die API sofort auf deinem eigenen Konto aufrufen. Ideal für Skripte, Tests und interne Tools.
OAuth 2.0: für Produkte, die deine Kunden nutzen. Deine Anwendung erhält eigenen Zugriff auf die Daten jedes Kunden, mit dessen Einverständnis, ohne dass jemand Passwörter oder Token teilen muss.
So sieht OAuth für deinen Kunden aus
In deiner App klickt der Kunde auf etwas wie Plugchoice verbinden.
Der Kunde landet auf dem vertrauten Plugchoice-Anmeldebildschirm und meldet sich mit seinem eigenen Konto an.
Plugchoice bittet ihn, den von deiner App angeforderten Zugriff zu bestätigen, mit einem Klick.
Er wird direkt zurück in deine App geleitet, die nun sicher eigene Token für diesen Kunden erhält.
Kein manuelles Kopieren von Token, keine geteilten Passwörter, und der Kunde kann den Zugriff jederzeit wieder entziehen. Das ist derselbe Ablauf, den Kunden schon vom Verbinden anderer Dienste kennen.
Zugang erhalten
Um OAuth für deine Anwendung freizuschalten, brauchen wir nur eines von dir: deine redirect URL (die Adresse in deiner App, zu der der Kunde nach der Bestätigung zurückkehrt). Schick sie uns über den Messenger oder deinen Partnerkontakt, dann richten wir deinen OAuth-Client ein und senden dir die Zugangsdaten.
Personal access tokens brauchen von uns gar keine Einrichtung: Erstelle eines im Dashboard und leg los.