Ресурси для розробників

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, бронювання, платіж або лист.