Начало / Быстрый старт

Быстрый старт

Авторизация, health-check и порядок подключения нового партнёра.

Авторизация

Каждому CarSharing-партнёру при подключении выдаётся персональный Bearer-токен — для вызовов CarSharing → Twin Turbo. Передаётся в заголовке на каждом запросе:

Authorization: Bearer <ваш-токен>

Отдельно, при настройке исходящих вызовов Twin Turbo → CarSharing (см. раздел «Исходящие вызовы»), стороны обмениваются:

  • базовым URL вашего API (куда стучится Twin Turbo);
  • API-ключом, который Twin Turbo передаёт вам в заголовке Authorization: Bearer <ключ> на каждый исходящий вызов — проверяйте его на своей стороне.
Отзыв токена Токен теряет силу при отзыве администратором Twin Turbo. Повторная выдача — по обращению к контактному лицу со стороны Twin Turbo.

Health-check

Проверка доступности сервиса Twin Turbo — без авторизации.

GET /v1/healthz
Ответ 200
{ "status": "ok" }

Порядок подключения

  1. Twin Turbo регистрирует вас как партнёра в своей системе и выдаёт Bearer-токен.
  2. Вы предоставляете базовый адрес и API-ключ для исходящих вызовов (см. «Исходящие вызовы»).
  3. Вы реализуете пять эндпоинтов раздела «Исходящие вызовы» на своей стороне — можно начать с заглушек, всегда отвечающих success: true, и подключить реальную логику позже.
  4. Стороны тестируют полный цикл заказа на тестовом контуре перед переходом в прод.

По вопросам подключения и тестового доступа — обращайтесь к вашему контактному лицу со стороны Twin Turbo.