Die von Tesla neu eingeführte Bepreisung der API-Nutzung berechnet alle Kosten an den Eigentümer der App. Damit ist es leider nicht mehr möglich, OpenSource-Apps über eine zentrale App-Registrierung anzubinden.
Tesla erlaubt aber die private Nutzung der API mit einer eigenen App-Registrierung. Dazu kann jeder Nutzer ein Entwickler-Konto bei Tesla anlegen. In diesem Entwicklerkonto kann eine App angelegt bzw. registriert werden.
Mit dieser App-Registrierung kann eine Anwendung die API verwenden. Die Aufrufe werden je App-Registrierung summiert und je nach Aufrufart (Datenabrufe, Kommandos) berechnet.
Im Tesla-Entwicklerbereich sind Informationen zu den Kosten verfügbar. Außerdem können die vorraussichtlichen Kosten auf Basis der Nutzung berechnet werden.
Für die Homey-App sind hierfür nur die Datenabrufe, Kommandos und Weck-Kommandos relevant.
Entwickler-Konto anlegen
Das benötigte Entwicklerkonto kann unter https://developer.tesla.com/ angelegt werden. Dafür kann das bereits für dein Fahrzeug erstellt Konto bzw. die eMail-Adresse verwendet werden.
- Öffne den Tesla-Entwicklerbereich
- Registriere dich als Entwickler
In Entwicklerbereich kann nun eine App angelegt werden.
App anlegen
Zur Registrierung werden ein paar allgemeine Informationen wie Name und Beschreibung angegeben.
Auf der zweiten Seite müssen technische Details zur Authentifizierung und der dafür verwendeten Domains bzw. URLs angegeben werden.
Als erlaubten Herkunft müssen folgende URLs angegeben werden:
- https://athom.com
Für den Authentifizierungsaufruf (oAuth2) - https://rwdevelopment.de
Für die Veröffentlichung des Zertifikats (PublicKey) sowie die Registrierung als Fahrzeugschlüssel
Als Weiterleitungs-URL muss folgende URL angegeben werden:
- https://callback.athom.com/oauth2/callback
Für die Authentifizierung über oAuth2
Im nächsten Schritt müssen die zu verwendenden „Scopes“ angegeben werden. Damit wird definiert, auf welche API-Inhalte die App zugreifen darf. Wähle hier alle Konto- und Fahrzeug-Scopes aus.
Im nächsten Schritt können Rechnungsdaten angegeben werden. Das ist nur notwendig, wenn eine kostenpflichtige API-Verwendung über den freien monatlichen Betrag in Höhe von 10$ hinaus gewünscht ist. Der Schritt kann daher erst einmal übersprungen werden.
In den App-Details können nun client_id und client_secret kopiert werden, um die Homey-App einzurichten.
Homey-App einrichten
Ist die App im Tesla-Konto eingerichtet, dann kann die Homey-App eingerichtet werden.
Füge dazu das Fahrzeug in Homey ein.
Die App-Anmeldeinformationen client_id und client_secret werden nun eingefügt.
Die Homey-App stellt nun den öffentlichen Schlüssel eines Schlüsselpaares bereit. Dieser Schlüssel wird über eine eindeutige URL bei Tesla mit der Tesla-App verknüpft.
Athom stellt dazu eine Weiterleitung über die Athom-Cloud bereit, um den auf deinem Homey bereitgestellten Schlüssel über eine Homey-spezifische URL zu veröffentlichen. Damit kann die Homey-App verwendet werden, auch ohne eine private Domain zu besitzen, auf der der Schlüssel sonst hätte veröffentlicht werden müssen.
Nach dem Einfügen des Fahrzeugs zu Homey kann im letzten Schritt die Homey-App als Fahrzeugschlüssel hinzugefügt werden. Das ermöglicht das Senden von verschlüsselten und signierten Kommandos an das Fahrzeug.
