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

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

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

HTTP-код	Типовой code	Значение
400	`bad_request`	Некорректные данные в запросе
401	`invalid_credentials`	Токен отсутствует, неверен или отозван
404	`not_found`	Ресурс не найден
409	`conflict` / `car_removed_from_fleet`	Конфликт состояния

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

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