Twin Turbo Partner API — Обзор

Схема интеграции с API Twin Turbo

Версия документа 1.0 — 2026-07-05. Интеграция для CarSharing-партнёров (выездная заправка автопарка).

Кто есть кто

  • CarSharing — оператор каршеринга (партнёр-заказчик).
  • Twin Turbo — сервис выездной заправки автомобилей CarSharing.

Архитектура — два шлюза

Интеграция построена на связи двух независимых направлений вызовов:

  1. Входящий API Twin Turbo — CarSharing создаёт / отменяет заказы на заправку и опционально управляет списком своих машин через API Twin Turbo. См. раздел «Заказы».
  2. Исходящий API CarSharing — Twin Turbo обращается к API CarSharing, чтобы поставить машину в технический резерв на время заправки, открыть/закрыть её и передать финальные данные по заправке. См. раздел «Исходящие вызовы».
Формат Весь обмен — JSON поверх HTTPS. Кодировка — UTF-8.

Базовый адрес

https://api.twinturbo.pro/v1/

Тестовый контур (для интеграционного тестирования перед продом): https://api.twinturbo.tech/v1/.

Версионирование

Контракт находится в /v1/*. Мы обязуемся не ломать /v1 обратно несовместимо — любые изменения будут только аддитивными (новые опциональные поля). О breaking-изменениях (переход на /v2) стороны договариваются заранее.