Задача

Разработать backend-интеграцию со стороны поставщика услуг трансферов. Все методы API должны строго соответствовать предоставленному интерфейсу.

Цель

Организовать полный цикл работы с заказами: возможность поиска доступных трансферов, их бронирование, отслеживание статусов и отмена по API.

Необходимые методы

  • POST /search - поиск свободных трансферов по заданным параметрам
  • POST /book - создание бронирования выбранного варианта трансфера
  • POST /status - получение или обновление статуса текущей поездки
  • POST /cancel - отмена подтверждённого бронирования

Формат спецификации

Работа выполняется согласно официальной схеме OAS3 (OpenAPI 3.0). Требуется строго следовать задокументированным контрактам и типам данных.

Требования к реализации

  • Работоспособность всех эндпоинтов
  • Обработка и валидация входящих запросов
  • Чёткое следование протоколу HTTP и форматам ответов (JSON)
  • Логирование ошибок и корректная обработка исключительных ситуаций

Решение сдается в виде функционирующей API-интеграции с примерами запросов-ответов.