diff --git a/blog/2025-01-20/tesla-api-update.mdx b/blog/2025-01-20/tesla-api-update.mdx index 16948367f7..8cb0879ce4 100644 --- a/blog/2025-01-20/tesla-api-update.mdx +++ b/blog/2025-01-20/tesla-api-update.mdx @@ -13,7 +13,10 @@ Die Nutzung bleibt weiterhin kostenfrei, erfordert jedoch einen zusätzlichen Ei {/* truncate */} :::note Update -8.2.2025: Weitere detaillierte Anleitungen für die Tesla Fleet API und myteslamate.com-Konfiguration. +Dieser Beitrag wurde überarbeitet. + +**[8.2.2025](https://github.com/evcc-io/docs/pull/723/files):** Weitere detaillierte Anleitungen für die Tesla Fleet API und myteslamate.com-Konfiguration.
+**[27.3.2025](https://github.com/evcc-io/docs/pull/775/files):** Aktualisierung auf den neuen Einrichtungsprozess von myteslamate.com. ::: ## Tesla Fleet API wird ab Februar kostenpflichtig @@ -46,33 +49,26 @@ Dort kannst du dir mit deinem Developer Account passende **Access- und Refresh-T ### Für Tesla-Fahrer {#vehicle} -Hier ist eine Schritt-für-Schritt-Anleitung, um deinen Tesla Developer Account (1) und myteslamate.com (2) einzurichten. -Wir empfehlen, diese Schritte parallel in zwei Browserfenstern auszuführen, da sie voneinander abhängig sind (siehe Sprunghinweise). - -1. Erstelle eine **Tesla Fleet API Application** - 1. Melde dich mit deinen Tesla-Zugangsdaten im [Tesla Developer Portal](https://developer.tesla.com/) an - 2. Klicke auf **Create New Application** und folge den Anweisungen - 3. Anwendungsdetails: Wähle einen Namen, eine Beschreibung und einen Verwendungszweck nach Belieben (springe zu 2.1.) - 4. Kundendetails: Gib die drei URLs ein, die myteslamate.com dir bereitstellt - 5. API/Berechtigungen: Wähle diese Berechtigungen - - Profilinformationen - - Fahrzeugdaten - - Fahrzeugstandort _(für Fahrzeugerkennung, noch nicht implementiert)_ - - Fahrzeugbefehle _(für Wakeup)_ - - Fahrzeugladungskontrolle _(nur für TWC-Nutzer, siehe [Anleitung unten](#charger))_ - 6. Rechnungsdetails: Kann übersprungen werden - 7. Du erhältst eine **Client ID** (Kunden-ID) und ein **Client Secret** (Kundengeheimnis) (springe zu 2.4.) -2. Erstelle einen **myteslamate.com Account** - 1. Gehe zu [myteslamate.com](https://app.myteslamate.com/) - 2. Wähle die Option **Fleet API & Telemetry** - 3. Melde dich mit deinen Tesla-Zugangsdaten an - 4. Verwende deine persönlichen URLs (Origin, Redirect, Callback) um die Tesla-Anwendung zu registrieren (springe zu 1.4.) - 5. Gib deine **Client ID** und **Client Secret** ein - 6. In der "kostenlos und direkt" Sektion erhältst du deine **Access- und Refresh-Token** - 7. Kopiere beide Token in deine evcc-Konfiguration - 8. Klicke auf die Schaltfläche **Tokens von MyTeslaMate löschen**
- _Dies ist wichtig und stellt sicher, dass evcc die einzige Anwendung ist, die diese Token verwendet. - Die Verwendung mehrerer Anwendungen (einschließlich myteslamate.com) mit denselben Token führt zu Token-Aktualisierungsproblemen._ +Für die Einrichtung in evcc benötigst du drei Informationen: + +- **Kunden ID (Client ID):** aus dem [Tesla Developer Portal](https://developer.tesla.com/) +- **Access Token:** über das Script von [myteslamate.com](https://www.myteslamate.com/tesla-api-application-registration/) +- **Refresh Token:** über das Script von [myteslamate.com](https://www.myteslamate.com/tesla-api-application-registration/) + +Folge der Anleitung auf [myteslamate.com](https://www.myteslamate.com/tesla-api-application-registration/) um diese Informationen zu generieren. + +Da du parallel auf myteslamate.com und developer.tesla.com unterwegs bist, empfehlen wir dir, diese Schritte parallel in zwei Browserfenstern auszuführen. +Am Ende des Prozesses muss ein Script heruntergeladen und auf deinem Rechner im Terminal/Konsole ausgeführt werden. + +Im Anmeldeprozess erscheint ein Berechtigungsdialog. +evcc benötigt für den Betrieb an einer normalen Wallbox (nicht Tesla Wall Connector) folgende **Tesla API Berechtigungen**: + +- Profilinformationen _(Region, Liste der Fahrzeuge)_ +- Fahrzeugdaten _(Ladestand, Fahrzeugstatus, etc.)_ +- Fahrzeugstandort _(für Fahrzeugerkennung, noch nicht implementiert)_ +- Fahrzeugbefehle _(für Wakeup)_ + +Hast du den Prozess erfolgreich abgeschlossen trage die Informationen in die evcc-Konfiguration ein: Beispiel: @@ -86,8 +82,6 @@ vehicles: refreshToken: EU_1234567890... # von myteslamate.com ``` -Auf myteslamate.com findest du auch eine [detailliertere Erklärung und Anleitung](https://www.myteslamate.com/tesla-api-application-registration/). - Dein verbrauchtes Guthaben kannst du in der [Übersicht im Tesla Developer Portal](https://developer.tesla.com/de_DE/dashboard/) jederzeit nachverfolgen. :::note @@ -99,14 +93,15 @@ Schau dir vor der Nutzung die [Terms of Service](https://www.myteslamate.com/ter ### Für Tesla Wall Connector Nutzer {#charger} -Wenn du einen Tesla Wall Connector verwendest, sind zusätzliche Schritte erforderlich, da die Ladekommandos eine signierte Kommunikation benötigen. -myteslamate.com bietet für 12 € pro Jahr einen "Command Proxy" an, der diese Funktion bereitstellt. +Wenn du einen Tesla Wall Connector verwendest, sind zusätzliche Schritte erforderlich, da die Ladekommandos 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 auf Nutzungsbasis direkt über myteslamate.com. +Für diese Kommandos wird nicht dein Tesla-Guthaben verwendet. Wir gehen davon aus, dass du die [oben beschriebenen Schritte](#vehicle) bereits abgeschlossen hast. - -1. Logge dich ein weiteres Mal bei [myteslamate.com](https://app.myteslamate.com/) ein nachdem du deine Token gelöscht hast (siehe 2.8.) -2. Kopiere das **Proxy-Token** aus der Sektion **Tesla API über unseren Proxy** -3. Füge das token in deine evcc-Konfiguration ein +Logge dich erneut auf myteslamate.com ein und folge der Einleitung zur Einrichtung des kostenpflichtigen Command-Proxys. +Kopiere das **Proxy-Token** aus der Sektion **Use MyTeslamate API**. +Trage dieses Token in die evcc-Konfiguration ein: ```yaml {8} vehicles: @@ -127,8 +122,6 @@ Es ist empfehlenswert die Berechtigungen bei myteslamate.com auf die nötigsten Für evcc sind nur die Funktionen **Charge Start**, **Charge Stop** und **Set Charging Amps** notwendig. ::: -## Nutzungsdaten - ## tesla.evcc.io wird eingestellt tesla.evcc.io wird im Februar eingestellt. diff --git a/i18n/en/docusaurus-plugin-content-blog/2025-01-20/tesla-api-update.mdx b/i18n/en/docusaurus-plugin-content-blog/2025-01-20/tesla-api-update.mdx index d838547b99..d8f680000b 100644 --- a/i18n/en/docusaurus-plugin-content-blog/2025-01-20/tesla-api-update.mdx +++ b/i18n/en/docusaurus-plugin-content-blog/2025-01-20/tesla-api-update.mdx @@ -13,7 +13,11 @@ The usage remains free of charge, but requires an additional setup step. {/* truncate */} :::note Update -8.2.2025: More detailed instructions for the Tesla Fleet API and myteslamate.com configuration. +This post has been revised. + +**[8.2.2025](https://github.com/evcc-io/docs/pull/723/files):** More detailed instructions for the Tesla Fleet API and myteslamate.com configuration.
+**[27.3.2025](https://github.com/evcc-io/docs/pull/775/files):** Update to the new setup process of myteslamate.com. + ::: ## Paid Tesla Fleet API starting February @@ -28,7 +32,7 @@ The billing is based on usage, with costs varying depending on the type of reque With [tesla.evcc.io](https://tesla.evcc.io) we have provided a service that allows evcc users to generate access tokens for API usage. The API communication of these tokens would be billed to us starting February 2025. The costs per user depend on the number of vehicles, charging behavior, and the specific configuration of the update interval. -For most users, these costs exceed our "$2 im Monat" sponsoring model and would not be sustainable for us, even if we would require sponsorship for Tesla integration. +For most users, these costs exceed our "$2 per month" sponsoring model and would not be sustainable for us, even if we would require sponsorship for Tesla integration. ## Free API credit for private users @@ -47,33 +51,26 @@ So we decided not to reinvend the wheel. ### For Tesla drivers {#vehicle} -Here is a step-by-step guide to help you set up your Tesla Developer (1) and myteslamate.com (2) account. -We recommend to use two browser windows, since both have to be done somewhat in parallel (see skip hints). - -1. Create a **Tesla Fleet API Application** - 1. Log into your [Tesla Developer Portal](https://developer.tesla.com/dashboard) (use your Tesla credentials) - 2. Click **Create New Application** and follow the wizard - 3. Application Details: Pick a name, description and usage you like. (skip to 2.1.) - 4. Client Details: Fill in the three URLs provided by myteslamate.com - 5. API/Scope: Select these scopes - - profile information - - vehicle information - - vehicle location _(for vehicle detection, not implemented yet)_ - - vehicle commands _(for wakeup)_ - - vehicle charging management _(only for TWC owners, see [instructions below](#charger))_ - 6. Billing Details: Can be skipped - 7. You'll receive a **Client ID** and a **Client Secret** (skip to 2.4.) -2. Create a **myteslamate.com account** - 1. Visit [myteslamate.com](https://app.myteslamate.com/) - 2. Select the free **Fleet API & Telemetry** option - 3. Sign in with your Tesla account - 4. Use your personal URLs (Origin, Redirect, Callback) to complete the Tesla Application registration (skip to 1.4.) - 5. Enter your **Client ID** and **Client Secret** - 6. In the "free and directly" section you will receive your **Access- and Refresh-Tokens** - 7. Copy both tokens to your evcc configuration - 8. Click the **Delete these tokens from MyTeslaMate** button.
- _This is important and ensures, that evcc is the only application to use these tokens. - Having multiple applications (including myteslamate.com) use the same tokens will lead to token refresh issues._ +For the setup in evcc you need three pieces of information: + +- **Client ID:** from the [Tesla Developer Portal](https://developer.tesla.com/) +- **Access Token:** via the script from [myteslamate.com](https://www.myteslamate.com/tesla-api-application-registration/) +- **Refresh Token:** via the script from [myteslamate.com](https://www.myteslamate.com/tesla-api-application-registration/) + +Follow the instructions on [myteslamate.com](https://www.myteslamate.com/tesla-api-application-registration/) to generate this information. + +Since you'll be working on myteslamate.com and developer.tesla.com in parallel, we recommend doing these steps in two browser windows simultaneously. +At the end of the process, a script must be downloaded and executed on your computer in the terminal/console. + +During the login process, a permissions dialog will appear. +For operation with a normal wallbox (not Tesla Wall Connector), evcc requires the following **Tesla API permissions**: + +- Profile information _(region, list of vehicles)_ +- Vehicle information _(charge level, vehicle status, etc.)_ +- Vehicle location _(for vehicle detection, not implemented yet)_ +- Vehicle commands _(for wakeup)_ + +Once you have successfully completed the process, enter the information in the evcc configuration: Example: @@ -82,13 +79,11 @@ vehicles: - 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 + clientId: aaaaaa-11111-... # from developer.tesla.com + accessToken: ey1234567890... # from myteslamate.com + refreshToken: EU_1234567890... # from myteslamate.com ``` -You can also find a [more detailed explanation and guide on myteslamate.com](https://www.myteslamate.com/tesla-api-application-registration/). - You can track your used API credit in the [Overview of the Tesla Developer Portal](https://developer.tesla.com/dashboard/). :::note @@ -100,24 +95,25 @@ Please refer to the [Terms of Service](https://www.myteslamate.com/terms-of-serv ### For Tesla Wall Connector users {#charger} -If you use a Tesla Wall Connector, additional steps are required, as the charging commands require signed communication. -myteslamate.com offers a "Command Proxy" for 12 € per year, which provides this functionality. +If you use a Tesla Wall Connector, additional steps are required, as the charging commands require signed communication and must be handled through a publicly accessible server. +myteslamate.com provides such a proxy. +Billing is done on a usage basis directly through myteslamate.com. +These commands do not use your Tesla API credit. We assume you've already completed the [steps described above](#vehicle). - -1. Log into your [myteslamate.com](https://app.myteslamate.com/) account a second time after you've deleted you tokens (see 2.8.) -2. Copy the **Proxy-Token** from the **Use your Tesla API via our proxy** section. -3. Insert the token into your evcc configuration. +Log into myteslamate.com again and follow the instructions to set up the paid command proxy. +Copy the **Proxy-Token** from the **Use MyTeslamate API** section. +Insert this token into your evcc configuration: ```yaml {8} vehicles: - 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 + clientId: aaaaaa-11111-... # from developer.tesla.com + accessToken: ey1234567890... # from myteslamate.com + refreshToken: EU_1234567890... # from myteslamate.com + proxyToken: aaaaa-bbbbb-... # from myteslamate.com ``` With this setup, evcc will send charging commands to the myteslamate.com proxy, which will sign it with your Tesla application and forward it to the original Tesla API. @@ -128,8 +124,6 @@ It is recommended to limit the permissions at myteslamate.com to the necessary f For evcc, only the functions **Charge Start**, **Charge Stop** and **Set Charging Amps** are necessary. ::: -## Usage data - ## tesla.evcc.io will be discontinued tesla.evcc.io will be discontinued in February.