Перейти к основному содержимому
Войти

API для провайдеров трансфера

Методы API, доступные для роли "transfer_provider".

Аутентификация​

Authorization: Bearer <your-token>

Управление маршрутами​

Создать маршрут​

POST /transfers

Пример запроса:

{
  "name": "Аэропорт - Архыз",
  "from_location": "Аэропорт Минеральные Воды",
  "to_location": "Архыз, центр",
  "distance_km": 210,
  "duration_minutes": 180,
  "price_per_person": 1500,
  "vehicle_type": "микроавтобус",
  "max_passengers": 18
}

Обновить маршрут​

PUT /transfer-routes/{id}

Получить мои маршруты​

GET /transfer-routes/my

Управление автопарком​

Добавить автомобиль​

POST /vehicles

Пример запроса:

{
  "make": "Mercedes",
  "model": "Sprinter",
  "year": 2022,
  "license_plate": "А123АА123",
  "capacity": 18,
  "vehicle_type": "микроавтобус",
  "amenities": ["кондиционер", "wi-fi", "usb"],
  "status": "active"
}

Обновить статус автомобиля​

PUT /vehicles/{id}/status

Получить автопарк​

GET /vehicles/my

Управление водителями​

Добавить водителя​

POST /drivers

Пример запроса:

{
  "name": "Иван Петров",
  "phone": "+7900123456",
  "license_number": "1234567890",
  "experience_years": 10,
  "languages": ["ru", "en"],
  "rating": 4.8
}

Назначить водителя на рейс​

POST /transfer-schedules/{id}/assign-driver

Управление расписанием​

Создать расписание трансфера​

POST /transfer-schedules

Пример запроса:

{
  "route_id": "uuid",
  "departure_time": "2024-07-15T08:00:00Z",
  "arrival_time": "2024-07-15T11:00:00Z",
  "vehicle_id": "uuid",
  "driver_id": "uuid",
  "available_seats": 18,
  "price_override": 1200
}

Обновить расписание​

PUT /transfer-schedules/{id}

Управление бронированиями​

Просмотр бронирований​

GET /transfer-bookings/my

Подтвердить бронирование​

PUT /transfer-bookings/{id}/confirm

Отменить бронирование​

PUT /transfer-bookings/{id}/cancel

Аналитика трансферного провайдера​

Статистика​

GET /analytics/transfer-provider

Ответ включает:

  • Общее количество маршрутов
  • Активные маршруты
  • Общее количество автомобилей
  • Общее количество водителей
  • Общее количество бронирований
  • Подтвержденные бронирования
  • Общий доход

Популярные маршруты​

Анализ самых востребованных направлений.

Загруженность по времени​

Статистика по популярным временным слотам.

Финансы​

Отчет по доходам​

GET /reports/transfer-revenue

Комиссионные​

GET /transfer-commissions

Уведомления​

Получить уведомления​

GET /notifications

Отметить уведомление как прочитанное​

PUT /notifications/{id}/read

Профиль​

Получить профиль​

GET /auth/me

Обновить профиль провайдера​

PUT /transfer-provider-profile

Дополнительные возможности​

Специальные предложения​

Создание акций и скидок для определенных маршрутов.

Групповые трансферы​

Управление коллективными заказами.

Интеграция с отелями​

Партнерские программы с отелями.

Коды ответов​

  • 200 - Успешно
  • 201 - Создано
  • 400 - Неверный запрос
  • 401 - Не авторизован
  • 403 - Доступ запрещен
  • 404 - Не найдено
  • 500 - Ошибка сервера

Полная документация: https://stage.arkhyz-club.ru/docs#/