Mit der Plugchoice REST API bauen Sie Ihr eigenes Produkt auf der Plattform auf: Ladestationen, Ladevorgänge 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 finden Sie 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.
Sie bauen mit einem KI-Assistenten? Geben Sie ihm developer.plugchoice.com/llms.txt (den Index) oder llms-full.txt (die gesamte Dokumentation in einer Datei). Ihr KI-Coding-Tool kann dann Fragen zur API beantworten und die Integration für Sie schreiben.
Zwei Wege zur Authentifizierung
Personal access token: der schnellste Einstieg, für die eigene Nutzung Ihres eigenen Kontos, etwa für Skripte, Tests, Hausautomation oder ein eigenes Dashboard. Erstellen Sie ein Token im Webportal unter Einstellungen > Ihr Konto > API-Tokens mit API-Token erstellen. Für die Nutzung in einem Produkt oder Dienst für andere oder für den Zugriff auf Daten anderer Konten brauchen Sie API Professional.
OAuth 2.0 (API Professional): für Produkte, die Ihre Kunden nutzen. Ihre Anwendung erhält eigenen Zugriff auf die Daten jedes Kunden, mit dessen Einverständnis und innerhalb der Scopes, die er freigibt, ohne dass jemand Passwörter oder Tokens teilt. API Professional läuft über eine separate Vereinbarung zu Scopes, Rate Limits und Gebühren.
So sieht OAuth für Ihren Kunden aus
In Ihrer App klickt der Kunde auf etwas wie Plugchoice verbinden.
Er landet auf dem Plugchoice-Anmeldebildschirm und meldet sich mit seinem eigenen Konto an, auch mit Google oder Apple.
Plugchoice zeigt, welchen Zugriff Ihre App anfragt, und der Kunde bestätigt mit Autorisieren.
Er wird zu Ihrer App zurückgeleitet, die nun eigene Tokens für diesen Kunden erhält.
Niemand kopiert Tokens oder teilt Passwörter. Der Kunde kann den Zugriff jederzeit im Webportal unter Einstellungen > Ihr Konto > Verbundene Apps widerrufen (Zugriff widerrufen), und für eine einzelne Ladestation unter deren Einstellungen > Apps.
Ihre Kunden und ihre Daten
Ihre App nutzt die Daten eines Kunden nur innerhalb der Scopes, die er freigegeben hat, und für Ihren eigenen Dienst an diesen Kunden.
Eigentumsübertragungen, Zugriffsfreigaben und andere Einwilligungsschritte werden nie automatisiert: Der Nutzer bestätigt jeden einzelnen.
Wer über Ihre App, Link oder die API ein Plugchoice-Konto erhält, ist Kunde von Plugchoice nach unseren Bedingungen, sofern nicht eine unterzeichnete Vereinbarung Ihnen diese Kundenbeziehung gibt. Wir dürfen diese Kunden selbst informieren und ihnen die Plugchoice App zeigen.
Widerruft ein Kunde den Zugriff oder löscht er sein Konto, sendet Ihre App keine Befehle mehr an seine Ladestationen, löscht die über die API erhaltenen personenbezogenen Daten unverzüglich und andere API-Daten innerhalb von 30 Tagen.
Zugang erhalten
OAuth gehört zu API Professional. Senden Sie uns Ihre Redirect-URL (die Adresse in Ihrer App, zu der der Kunde nach der Freigabe zurückkehrt) über den Messenger oder Ihren Partnerkontakt. Sobald die Vereinbarung steht, richten wir Ihren OAuth-Client ein und senden Ihnen die Zugangsdaten.
Personal access tokens müssen wir nicht einrichten: Erstellen Sie eines im Webportal und legen Sie los.