EV-Ladegerät APIs

Was wird freigelegt

Lesen und Steuern sind unterschiedliche Probleme

Der Lesestatus ist ein normales API-Problem. Das Ausgeben eines Befehls ist nicht der Fall, da der Befehl an physische Geräte weitergeleitet wird, die möglicherweise nicht zuhören, und die Antwort, die Sie erhalten, sich eher auf die Anfrage als auf das Ergebnis bezieht.

• Ein erfolgreicher Fernstart bedeutet, dass der Befehl angenommen wurde und nicht, dass ein Auto aufgeladen wird. Das Ergebnis kommt später als Zustandsänderung
• Das Ladegerät ist möglicherweise offline. In diesem Fall muss der Befehl in der Warteschlange stehen, abgelehnt oder abgelaufen sein, und Ihre Anwendung muss wissen, welcher Befehl vorliegt
• Die physische Welt kann Ihnen widersprechen: Kein Fahrzeug angeschlossen, der Laderaum ist von einem Auto belegt, das nicht lädt, der Stecker ist nicht eingerastet
• Befehle müssen idempotent sein, da ein Client, der keine Antwort gesehen hat, es erneut versucht

Daher werden Steuervorgänge getrennt von Lesevorgängen autorisiert, und eine Integration sollte so konzipiert sein, dass sie Ergebnisse beobachtet, anstatt Bestätigungen zu vertrauen.

Echtzeit-Updates erhalten

1. 1

   Webhooks

   Die Plattform postet Veranstaltungen für Sie. Effizient und die richtige Voreinstellung. Erfordert, dass Sie erreichbar sind, schnell reagieren und mit Duplikaten und Lieferungen außerhalb der Reihenfolge umgehen können.

2. 2

   Streaming

   Eine dauerhafte Verbindung für kontinuierliche Telemetrie. Geeignet für ein Live-Dashboard, für die meisten Anwendungen unnötig und macht Ihren Client zustandsbehaftet.

3. 3

   Umfrage

   Einfach, funktioniert immer und lässt sich schlecht skalieren. Gut für eine Handvoll Ladegeräte und falsch für ein Netzwerk. Außerdem führt es zu veralteter Verfügbarkeit, was den Fehler darstellt, den Benutzer bemerken.

Die meisten Integrationen enden mit Webhooks für Ereignisse und einer engen Umfrage für die spezifischen Dinge, die niemals veraltet sein dürfen, was in der Praxis die Verfügbarkeit ist.

Authentifizierung und Scoping

• Anmeldeinformationen beziehen sich auf eine Reihe von Ladegeräten oder Standorten, nicht auf das gesamte Netzwerk, sodass eine Partnerintegration nicht über den eigenen Bereich hinausgehen kann
• Lesen und Steuern sind getrennt, sodass eine Analyseintegration keine Sitzungen starten kann
• Anmeldeinformationen pro Integration statt gemeinsamer Anmeldeinformationen, sodass der Zugriff widerrufen werden kann, ohne dass alles andere kaputt geht
• Benutzerkontext, in dem ein Endbenutzer handelt, sodass eine Aktion einer Person und nicht einer Anwendung zuzuordnen ist
• Ein Prüfpfad der Befehle, der nach einem Vorfall von Bedeutung ist

Ratenbegrenzungen und gutes Verhalten im Maßstab

Der Fehlermodus ist normalerweise nicht, dass ein Kunde missbräuchlich ist. Es handelt sich um hundert gut erzogene Clients, die alle innerhalb derselben Minutengrenze abfragen, oder um eine Flotte von Ladegeräten, die nach einem regionalen Ausfall gleichzeitig die Verbindung wiederherstellen und bei der jede Integration gleichzeitig reagiert.

• Machen Sie bei einer Ablehnung einen Rückzieher, anstatt es sofort noch einmal zu versuchen, was aus einer arbeitsreichen Zeit einen Ausfall macht
• Jittern Sie geplante Anfragen, anstatt sie auf die Minute abzustimmen
• Bevorzugen Sie Ereignisse gegenüber Abfragen, sofern die Daten dies zulassen
• Zwischenspeichern, was sich nicht ändert, nämlich die meisten Metadaten des Ladegeräts

Was bewusst nicht offengelegt wird

Manche Dinge werden absichtlich zurückgehalten, und das Wissen, was ein Integrationsdesign rettet, das nicht funktionieren kann.

• Alles, was es einem API-Anrufer ermöglichen würde, das Sicherheitsverhalten zu beeinflussen. Die Reihenfolge und der Schutz der Schütze sind konstruktionsbedingt nicht adressierbar
• Persönliche Rohdaten, die über das hinausgehen, was der Umfang der Integration rechtfertigt
• Direkter Protokollzugriff auf das Ladegerät, der den eigenen Status und die Autorisierung der Plattform umgehen würde
• Offensichtlich sind es die Daten anderer Mandanten zu einer gemeinsamen Bereitstellung, die eher bestätigt als angenommen werden sollten