Модель ошибок

Все ответы Twin Turbo на ваши запросы (разделы «Заказы» и «Парк машин») при ошибке имеют единый формат.

{
  "error": {
    "code": "invalid_credentials",
    "message": "человекочитаемое описание"
  }
}

HTTP-код	Типовой code	Значение
400	`bad_request`	Некорректные данные в запросе
400	`fuel_level_percent_out_of_range`	`fuel_level_percent` вне диапазона [0, 100]
400	`fuel_level_invalid`	`fuel_level_liters` отрицательный
400	`tank_capacity_invalid`	`tank_capacity_liters` <= 0 или > 300 (заказ или регистрация машины)
400	`fuel_level_exceeds_capacity`	`fuel_level_liters` больше разрешённой ёмкости бака более чем на 2% (допуск на погрешность датчика)
401	`invalid_credentials`	Токен отсутствует, неверен или отозван
404	`not_found`	Ресурс не найден
409	`conflict` / `car_removed_from_fleet`	Конфликт состояния

Идемпотентность

Создание заказа — по external_id. Повторный POST с тем же external_id никогда не создаёт дубль. См. создание заказа.
Отмена заказа — безопасно повторять DELETE любое количество раз. См. отмена заказа.
Регистрация машины — PUT безопасно повторять (обновляет запись). См. регистрация машины.
Ваши эндпоинты (раздел «Исходящие вызовы») — просим также обеспечить идемпотентность по order_id: асинхронное завершение заказа (finish) может быть доставлено повторно при сетевых сбоях на нашей стороне.