tesla-fleet-api

Use when integrating with Tesla's official Fleet API to read vehicle/energy device data or issue remote commands (e.g. start HVAC preconditioning, wake vehicle, charge controls). Covers onboarding (developer app registration, regions/base URLs), OAuth token flows (third-party + partner tokens, refresh rotation), required domain/public-key hosting, and using Tesla's official vehicle-command/tesla-http-proxy for signed vehicle commands.

1. Zainstaluj zależności: Python 3 i OpenSSL muszą być dostępne w systemie. Skill wymaga zmiennych środowiskowych TESLA_CLIENT_ID i TESLA_CLIENT_SECRET — uzyskaj je rejestrując aplikację w Tesla Developer Portal.

2. Skonfiguruj autoryzację uruchamiając skrypt auth.py. Jeśli potrzebujesz lokalnego serwera callback do OAuth, użyj tesla_oauth_local.py — wygeneruje on tokeny dostępu i odświeżające, które zostaną zapisane w auth.json.

3. Uruchom start_proxy.sh, aby włączyć serwer proxy do podpisywania komend. Proxy wymaga materiału TLS (certyfikaty i klucze) przechowywane w katalogu proxy/ — będą wygenerowane automatycznie podczas konfiguracji.

4. Pobierz listę swoich pojazdów wykonując vehicles.py — wyświetli dostępne samochody i zaktualizuje cache w vehicles.json.

5. Wydawaj komendy za pomocą command.py, np. do uruchomienia klimatyzacji, budzenia pojazdu lub sterowania ładowaniem. Jeśli posiadasz jeden samochód, zostanie wybrany automatycznie; dla wielu pojazdów wskaż go w parametrach.

6. Odczytuj dane pojazdu (stan baterii, temperatury, współrzędne) używając vehicle_data.py — dane są pobierane bezpośrednio z Fleet API bez konieczności dodatkowej konfiguracji poza tokenami.