Zum Inhalt springen
Smart laden

v0.133 - Tesla Developer Account erforderlich

Tesla API Update

Ab evcc v0.133 wird ein Tesla Developer Account benötigt. Die Nutzung bleibt kostenfrei, erfordert jedoch einen zusätzlichen Einrichtungsschritt.

Letztes Jahr haben wir die Tesla Fleet API in evcc integriert. Tesla war der erste Hersteller, der eine offizielle und vor allem offene API für die Kommunikation mit seinen Fahrzeugen bereitgestellt hat.

Tesla hatte bereits angekündigt, dass diese Schnittstelle nicht dauerhaft kostenlos bleiben würde. Die Preise sind nun bekannt und treten ab dem 1. Februar 2025 in Kraft. Die Abrechnung erfolgt nutzungsbasiert, wobei die Kosten je nach Art der Anfrage variieren.

Mit tesla.evcc.io haben wir bislang einen Dienst bereitgestellt, über den evcc-Nutzer Zugangstoken für die API-Nutzung generieren können. Die API-Anfragen über diese Token würden uns ab Februar 2025 in Rechnung gestellt. Die Kosten pro Nutzer hängen von der Anzahl der Fahrzeuge, dem Ladeverhalten und der konkreten Konfiguration des Aktualisierungsintervalls ab. Bei den meisten Nutzern überschreiten diese Kosten unser Sponsoring-Modell mit 2 $ pro Monat und wären für uns auch dann nicht tragbar, wenn wir die Tesla-Integration sponsorpflichtig machen würden.

Tesla bietet Privatnutzern ein monatliches API-Guthaben von 10 €, was für die meisten evcc-Nutzer ausreichen sollte.

Teslas API-Guthaben

Mit der Version 0.133 haben wir die API-Kommunikation zu Tesla so angepasst, dass du deinen eigenen Tesla Developer Account nutzen kannst. Token, die zuvor mit tesla.evcc.io generiert wurden, funktionieren nicht mehr. Wir haben überlegt, unseren bisherigen Prozess zur Token-Generierung so zu erweitern, dass du ihn mit deinem eigenen Tesla Developer Account nutzen kannst. Glücklicherweise hat myteslamate.com genau diese Funktion bereits implementiert. Dort kannst du dir mit deinem Developer Account Access- und Refresh-Token generieren. Daher haben wir uns entschieden, das Rad nicht neu zu erfinden.

Für die Einrichtung in evcc benötigst du drei Informationen:

Folge der Anleitung auf myteslamate.com, um diese Informationen zu generieren.

Da du parallel auf myteslamate.com und developer.tesla.com unterwegs bist, empfehlen wir dir, diese Schritte gleichzeitig in zwei Browserfenstern auszuführen. Am Ende des Prozesses muss ein Skript heruntergeladen und auf deinem Rechner im Terminal bzw. in der Konsole ausgeführt werden.

Im Anmeldeprozess erscheint ein Berechtigungsdialog. Für den Betrieb an einer normalen Wallbox (nicht Tesla Wall Connector) benötigt evcc folgende Tesla-API-Berechtigungen:

  • Profilinformationen (Region, Liste der Fahrzeuge)
  • Fahrzeugdaten (Ladestand, Fahrzeugstatus usw.)
  • Fahrzeugstandort (für die Fahrzeugerkennung, noch nicht implementiert)
  • Fahrzeugbefehle (zum Aufwecken)

Hast du den Prozess erfolgreich abgeschlossen, trag die Informationen in die evcc-Konfiguration ein:

Beispiel:

vehicles:
- name: my_car
type: template
template: tesla
title: Tesla Model 3
clientId: aaaaaa-11111-... # von developer.tesla.com
accessToken: ey1234567890... # von myteslamate.com
refreshToken: EU_1234567890... # von myteslamate.com

Dein verbrauchtes API-Guthaben kannst du in der Übersicht im Tesla Developer Portal nachverfolgen.

Wenn du einen Tesla Wall Connector verwendest, sind zusätzliche Schritte erforderlich, da die Ladebefehle eine signierte Kommunikation benötigen und über einen öffentlich zugänglichen Server abgewickelt werden müssen. myteslamate.com stellt einen solchen Proxy bereit. Die Abrechnung erfolgt nutzungsbasiert direkt über myteslamate.com. Für diese Befehle wird nicht dein Tesla-API-Guthaben verwendet.

Wir gehen davon aus, dass du die oben beschriebenen Schritte bereits abgeschlossen hast. Logge dich erneut auf myteslamate.com ein und folge der Anleitung zur Einrichtung des kostenpflichtigen Command-Proxys. Kopiere das Proxy-Token aus dem Abschnitt Use MyTeslamate API. Trage dieses Token in deine evcc-Konfiguration ein:

vehicles:
- name: my_car
type: template
template: tesla
title: Tesla Model 3
clientId: aaaaaa-11111-... # von developer.tesla.com
accessToken: ey1234567890... # von myteslamate.com
refreshToken: EU_1234567890... # von myteslamate.com
proxyToken: aaaaa-bbbbb-... # von myteslamate.com

Mit dieser Konfiguration sendet evcc Ladebefehle an den Proxy von myteslamate.com, der sie mit deiner Tesla-Anwendung signiert und an die eigentliche Tesla API weiterleitet.

tesla.evcc.io wird im Februar eingestellt. Alle damit generierten Token verlieren ihre Gültigkeit. Für die weitere Nutzung der Tesla API ist ein Update auf evcc 0.133 erforderlich.

Die Tesla-API-Kommunikation in evcc ist nicht an myteslamate.com gebunden. Du kannst die Token mit der entsprechenden Infrastruktur (öffentliche Callback-URL notwendig) auch selbst generieren und in die oben genannte evcc-Konfiguration eintragen.

Alternative Anbindungen über Dienste wie TeslaLogger, TeslaMate, TeslaBleHttpProxy, Tessie oder Tronity sind ebenfalls möglich.

Besitzer eines Tesla Wall Connectors können auch weiterhin TeslaBleHttpProxy als lokalen „Command-Proxy“ verwenden.

Wir haben mehrere Alternativen für die Tesla-Anbindung diskutiert. Auch spezielle Dienste und Preisstufen für Tesla-Nutzer lagen auf dem Tisch. Wir glauben, dass unsere aktuelle Lösung aus Nutzersicht die beste ist. Sie verursacht für die meisten Privatnutzer keine zusätzlichen Kosten. Die Implementierung bleibt sponsorfrei. Die API-Kommunikation erfordert keine Drittanbieterdienste. Auch Nutzer größerer Fahrzeugflotten können evcc nutzen, wobei die API-Nutzungsgebühren direkt bei Tesla anfallen, wenn das monatliche API-Guthaben überschritten wird.

Viele Grüße
Das evcc-Team
Michael, Andi & Uli