UK Tesla API Setup

Налаштування Tesla API

🤖 Цей український переклад створений з AI-підтримкою з англійського оригіналу. Виправлення приймаються на GitHub.

🌐 Мова: EN · DE · FR · ES · TR · EL · UK

Підключення Tesla Carview до вашого облікового запису Tesla вимагає облікового запису Tesla Developer і OAuth-застосунку. Цей процес займає близько 20–30 хвилин і його потрібно виконати лише один раз.

---

Огляд: Що тут відбувається?

Tesla використовує OAuth 2.0 — той самий стандарт, що використовується "Login with Google". Ви створюєте застосунок у портале розробника Tesla, який отримує Client ID і Client Secret. Tesla Carview використовує їх, щоб запитати доступ до даних вашого автомобіля з вашого дозволу.

Tesla Developer Portal
  → Зареєструвати застосунок → отримати Client ID + Secret
  → Ввести в Tesla Carview
  → Натиснути "Connect Tesla Account"
  → Відкривається сторінка входу Tesla
  → Ви схвалюєте доступ
  → Tesla надсилає токени до Tesla Carview
  → Дані течуть ✅

---

Крок 1: Створіть обліковий запис Tesla Developer

1. Перейдіть на developer.tesla.com
2. Увійдіть із вашим звичайним обліковим записом Tesla (той самий, який ви використовуєте для автомобіля)
3. Прийміть умови розробника

---

Крок 2: Зареєструйте ваш застосунок

1. У портале розробника натисніть "Add New Application"

2. Заповніть форму:

   Поле	Що ввести
   Application Name	Будь-що описове, напр. "My Tesla Carview"
   Description	"Private self-hosted Tesla data logger"
   Allowed Origin URL	https://tesla.yourdomain.com
   Redirect URI	https://tesla.yourdomain.com/api/auth/tesla/callback
   Application Type	Web Application

3. Під Scopes виберіть:

   • vehicle_device_data — для читання стану автомобіля
   • vehicle_cmds — для надсилання команд (клімат, замки тощо)
   • vehicle_charging_cmds — для керування заряджанням
   • offline_access — щоб залишатися підключеним без повторного входу щогодини

4. Натисніть Save

5. Запишіть ваш Client ID і Client Secret — вони знадобляться в наступному кроці

⚠️ Тримайте ваш Client Secret приватним. Він йде у ваш .env файл і ніколи не повинен передаватися чи коммітитися в git.

---

Крок 3: Налаштуйте Virtual Key (для команд)

Virtual Key — це механізм безпеки Tesla для надсилання команд автомобілю. Без нього ви можете читати дані, але не керувати чимось (не запускати клімат, не блокувати/розблоковувати).

Tesla Carview генерує ключ автоматично. Вам потрібно лише додати його у ваш автомобіль:

1. У Tesla Carview перейдіть до Settings → Virtual Key
2. Скопіюйте показану URL (виглядає як https://tesla.yourdomain.com/api/virtual-key/pair)
3. Відкрийте цю URL у браузері Tesla на сенсорному екрані автомобіля (не на телефоні)
4. Натисніть "Add key" на екрані автомобіля
5. Підтвердьте в застосунку Tesla на вашому телефоні (він просить вас схвалити новий ключ)

Після спарювання команди (клімат, блокування тощо) працюватимуть з Tesla Carview.

---

Крок 4: Введіть облікові дані в Tesla Carview

1. Перейдіть до Admin → System у Tesla Carview
2. Введіть ваш Client ID і Client Secret
3. Натисніть Save

Або додайте їх безпосередньо до .env файлу:

nano /opt/tesla-carview/backend/.env

TESLA_CLIENT_ID=your-client-id-here
TESLA_CLIENT_SECRET=your-client-secret-here

Потім перезапустіть:

docker compose -f /opt/tesla-carview/docker-compose.prod.yml up -d

---

Крок 5: Підключіть ваш обліковий запис Tesla

1. У Tesla Carview перейдіть до Dashboard → Connect Tesla Account (або підказка при першому вході)
2. Натисніть "Connect with Tesla"
3. Вас перенаправляє на сторінку входу Tesla — увійдіть із вашим обліковим записом Tesla
4. Tesla запитає, до якого автомобіля надати доступ — виберіть ваш автомобіль
5. Вас перенаправляє назад до Tesla Carview — зв'язок встановлено ✅

Застосунок тепер опитує дані вашого автомобіля кожні 60 секунд, поки автомобіль активний, і призупиняє опитування, коли автомобіль припаркований і спить (щоб не розряджати акумулятор).

---

Поширені проблеми

"403 Forbidden" на всіх викликах Tesla API

Ваш обліковий запис розробника Tesla може бути призупинений або обмежений за швидкістю. Це трапляється, якщо:

• Зроблено забагато викликів API (троттлинг)
• Ваша білингова інформація в порталі розробника неповна
• Tesla позначила обліковий запис

Перевірте developer.tesla.com — якщо ви бачите білингове повідомлення або повідомлення про призупинення, спочатку розв'яжіть це.

Автомобіль показує "offline" навіть під час руху

Tesla API має відоме обмеження: деякі новіші транспортні засоби (особливо ті, що мають VIN XP7, як Model Y Juniper) не повертають GPS-дані через стандартний endpoint. Tesla Carview використовує Fleet Telemetry для цих автомобілів. Це налаштовується автоматично.

Команди не працюють ("Virtual Key not paired")

→ Повторіть Крок 3 вище. Переконайтеся, що ви відкрили URL спарювання в браузері Tesla (а не на телефоні чи комп'ютері).

"Redirect URI mismatch"

Redirect URI в Tesla Developer Portal має точно відповідати тому, що ви ввели — включно з https://, правильним доменом і без зворотного слеша в кінці.

---

Як працює опитування даних

Tesla Carview опитує ваш автомобіль кожні 60 секунд за замовчуванням, коли автомобіль активний. Коли автомобіль спить (припаркований більше кількох хвилин), опитування сповільнюється до кожних 10 хвилин, щоб не будити автомобіль (що розряджає акумулятор 12 В).

Ви можете відрегулювати інтервал опитування у файлі .env:

POLL_INTERVAL_MS=60000        # 60 секунд (за замовчуванням)
POLL_SLEEP_INTERVAL_MS=600000 # 10 хвилин під час сну