Ресурсы для разработчиков

API поиска авиарейсов Bileteavia для ИИ-ассистентов

Интерфейс только для чтения, который ищет актуальные варианты перелёта и возвращает путешественника на Bileteavia с уже подготовленными маршрутом, датами и числом пассажиров.

Поиск только для чтения API v1 EUR

Актуальные результаты поиска

Маршруты, время, коды авиакомпаний и статус наличия нормализуются из ответа поставщика для запрошенных дат.

Клиентские цены

Каждая сумма проходит через текущие правила корректировки стоимости билета в панели Bileteavia. API не раскрывает базовый тариф поставщика или величину корректировки.

Безопасная граница операций

Поиск не создаёт сессию, лид, бронирование, платёж, письмо или уведомление Discord. Для бронирования используется отдельный процесс на сайте.

HTTP-контракт

Endpoint и параметры поиска

Отправьте GET-запрос с кодами аэропортов IATA и допустимой датой вылета. Неизвестные параметры отклоняются, чтобы интеграции не передавали неподдерживаемые данные незаметно.

GET https://bileteavia.md/api/v1/flights/search?origin=RMO&destination=CDG&departureDate=YYYY-MM-DD&passengers=1&currency=EUR
Параметр Обязательный Значение
origin Да Трёхбуквенный код IATA аэропорта вылета.
destination Да Трёхбуквенный код IATA пункта назначения, отличный от пункта вылета.
departureDate Да Дата вылета в формате ГГГГ-ММ-ДД, от сегодня до 370 дней вперёд.
returnDate Нет Необязательная дата возврата после вылета и в пределах 370 дней.
passengers Нет Число взрослых пассажиров от 1 до 9; по умолчанию 1.
cabin Нет economy или business; по умолчанию economy.
currency Нет В версии 1 только EUR, чтобы фиксированные корректировки из панели оставались валютно корректными.
baggage Нет Только any; включение багажа указывается как неподтверждённое.

Что означает успешный ответ

Ответ JSON помогает ассистентам точно описывать варианты, не превращая результат поиска в обещание бронирования.

  • Сумма указана в EUR, включает применимую корректировку из панели и помечена как ориентировочная.
  • Наличие фиксирует момент наблюдения варианта и всегда требует повторной проверки.
  • Маршруты вылета и возможного возврата содержат аэропорты, время, длительность, пересадки и коды авиакомпаний, когда поставщик их предоставляет.
  • continue_search_url открывает новый клиентский поиск на Bileteavia с нормализованными параметрами запроса.
Цена и наличие не гарантированы Bileteavia повторно проверяет выбранный вариант перед бронированием. Ассистент не должен утверждать, что место забронировано или показанный тариф окончательный.

Подключение endpoint к Gemini

Gemini не выполняет автоматически API, найденный в Google Search. Выполнением инструмента управляет интегрирующее приложение.

  1. 1Загрузите опубликованную декларацию функции Gemini и добавьте её в инструменты, передаваемые Gemini API.
  2. 2Когда Gemini вернёт search_bileteavia_flights, проверьте аргументы и вызовите GET endpoint Bileteavia с этими query-параметрами.
  3. 3Верните JSON-ответ Gemini и покажите путешественнику continue_search_url как следующее действие.

Публичная декларация является метаданными интеграции, а не автоматической регистрацией в Google, и не гарантирует показ в AI Overviews или AI Mode.

Продолжить на Bileteavia

API помогает находить и сравнивать варианты. Сайт остаётся клиентским местом для повторной проверки и перехода к бронированию.

Найти рейсы

Вопросы об API поиска

Будет ли Google AI автоматически вызывать этот API?

Нет. Google Search может индексировать и цитировать эту страницу документации, но приложение Gemini должно явно зарегистрировать функцию и выполнить вызов API.

Включают ли возвращаемые цены корректировки из панели Bileteavia?

Да. Публичная сумма уже включает применимую корректировку цены билета, настроенную в панели, но остаётся ориентировочной и требует повторной проверки.

Создаёт ли API-поиск лид или бронирование?

Нет. Поиск работает только для чтения и не создаёт сессию, CRM-лид, уведомление Discord, бронирование, платёж или письмо.