Авиабилеты

  1. Для каких сайтов
  2. Что добавляет в результаты поиска
  3. Как настроить
  4. Условия

Это старая версия документа, которая прекратила свое действие 08.02.2022 г. Действующая версия размещена по адресу: https://yandex.ru/support/webmaster/search-appearance/air-tickets.html

Для каких сайтов

Авиакомпании, турагентства, агенты по продаже авиабилетов.

Что добавляет в результаты поиска

Содержит варианты перелета с ценами на интересующие пользователя даты. Пользователь может указать требования к пересадкам, изменить направления и даты, уточнить наличие багажа и количество пассажиров, выбрать авиакомпанию, не покидая страницу поисковой выдачи, а затем перейти к покупке билета на сайте партнера.

Как настроить

Когда пользователь запрашивает варианты перелетов на выбранную дату, Яндекс отправляет запрос (GET или POST) к веб-сайту партнера в соответствии с форматом:

https://api.aviapartner.ru/search? [departure = <IATA либо Сирена-код пункта отправления>]
          &[arrival = <IATA либо Сирена-код пункта прибытия>]&[date_forward = <дата вылета «туда»>] &[date_backward = <дата вылета «обратно»>] &[class = <класс обслуживания>] &[adults =<количество взрослых
        пассажиров>] &[children = <количество детей>]&[infants = <количество младенцев>]
departure Код аэропорта отправления. Указывается код IATA или код в системе «Сирена-Трэвел».
arrival Код аэропорта прибытия. Указывается код IATA или код в системе «Сирена-Трэвел».
date_forward Дата прямого вылета в формате YYYY-MM-DD.
date_backward Дата обратного вылета в формате YYYY-MM-DD. Может отсутствовать.
class

Буквенное обозначение класса обслуживания. Допустимые значения:

  • Бизнес-класс — J, C, D, I, Z, BUSINESS.
  • Экономический класс — W, S, Y, B, H, K, L, M, N, Q, T, V, X, E, U, G, O, ECONOMY.
adults Количество пассажиров старше 12 лет.
children Количество пассажиров от 2 до 12 лет (включительно). Может отсутствовать.
infants Количество детей до 2 лет (включительно). Может отсутствовать.

 

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

https://api.aviapartner.ru/search?departure=MOW&arrival=AGP&date_forward=2017-03-19&date_backward=2017-03-26&class=E&adults=2&children=0&infants=1

Веб-сайт партнера возвращает информацию о доступных предложениях в формате XML, JSON. В ответе содержится один или несколько объектов variant, в каждом указаны сведения о перелете: ссылка для покупки билета на веб-сайте партнера и информация о рейсах «туда» (объект route_forward) и «обратно» (объект route_backward). Перелет может состоять из нескольких рейсов.

Для каждого варианта передаются:

  • цена, в том числе для каждого типа пассажиров, если это применимо,
  • валюта,
  • URL для перенаправления на сайт,
  • количество оставшихся мест,
  • возвратность (по сегменту с самими строгими условиями).

Остальные параметры заполняются для каждого сегмента.

* Поля, обязательные к заполнению и наличию в ответе.

Поле Описание Формат
url* URL для перенаправления пользователя на сайт партнера. Обработка URL на стороне партнера должна происходить в соответствии с п. 3.4 RFC 2396 – Uniform Resource Identifiers (URI): Generic Syntax. Строка
price* Цена варианта. Объект (Price)
route_forward* Информация о рейсе «туда». Список объектов (Segment)
route_backward* Информация о рейсе «обратно». Отсутствует, если в запросе не была указана дата обратного вылета. Список объектов (Segment)
value* Цена варианта в данном классе обслуживания. Число
currency* Валюта. Строка
tariff_adult В том числе стоимость для пассажиров старше 12 лет. Число
tariff_child В том числе стоимость для детей от 2 до 12 лет (включительно). Отсутствует, если в запросе не было указано количество детей. Число
tariff_infant В том числе стоимость для детей до 2 лет (включительно). Отсутствует, если в запросе не было указано количество младенцев. Число
refundable Возможность вернуть билет. Логический
seats_remaining Количество оставшихся мест по данной цене. Число

 

Segment
flight_number* Номер рейса. Строка
marketing_carrier* Код авиакомпании, которая продает билет. Указывается код IATA или код в системе «Сирена-Трэвел». Строка
operating_carrier* Перевозчик, выполняющий перевозку. Строка
operating_flight_number* Номер рейса оперирующего перевозчика. Строка
validating_carrier Код перевозчика, выписывающего билет. Строка
fare_family Название семейства тарифов. Строка
carrier_name Название авиакомпании. Строка
departure_airport_code* Код аэропорта вылета. Указывается код IATA или код в системе «Сирена-Трэвел». Строка
arrival_airport_code* Код аэропорта прибытия. Указывается код IATA или код в системе «Сирена-Трэвел». Строка
departure_datetime* Дата и время отправления (местные). Строка
arrival_datetime* Дата и время прибытия (местные). Строка
fare_code* Код тарифа. Строка
class* Обозначение класса обслуживания. Строка
charter* Признак чартерного тарифа. Логический
technical_stop* Техническая остановка. Логический
selfconnect* Признак выписки отдельных билетов для рейсов в перелете. Логический
luggage* Включен ли провоз сдаваемого багажа в стоимость билета. Объект, включающий поля с информацией о багаже.

Логический

Объект (Baggage)

hand_luggage* Объект, включающий поля с информацией о допустимых размерах ручной клади. Объект (Baggage)

 

Baggage
included* Наличие возможности без дополнительной оплаты провезти сдаваемый багаж. Логический
pieces* Число мест багажа. Число
weight* Вес багажа. Число
units* Единицы изменения веса. Строка
dimensions Объект, включающий поля с информацией о допустимых размерах багажа. Объект (Dimensions)

 

Dimensions
length Длина. Число
width Ширина. Число
height Высота. Число
sum Сумма длины, ширины и высоты. Число

Вся указанная выше информация о перелете обязательно должна быть включена в ответ (в соответствии с типами пассажиров в запросе).

Пример ответа
{ "variant" : [ { "url":
       "https://api.aviapartner.ru/redirect?key=gdfkj435lkfg", {
       "route_forward": [ { "route_code": "0123АБ",
       "company_code": "BL", "company_name":
       "Blah-air", "departure_airport_code": "DME",
       "arrival_airport_code": "SVO", "departure_datetime":
       "2011-04-01 18:12", "arrival_datetime": "2011-04-01
       21:20", "route_time = "123", "farecode":
       "WFLOWCS", "tariff_adult": "80.00",
       "tariff_child": "60.00", "tariff_infant":
       "3.45", "fare": { "value: "123.45",
       "class: "E", "charter: "false", "block":
       "false", "selfconnect": "false",
       "currency": "RUB", "luggage: "true",
       "pieces_of_luggage: 1, "luggage_weight": 20,
       "luggage_dimensions: { "length: 90, "width: 28, "height: 40,
       "sum: 158 } } }, {...}, {...} ] }, { "route_backward": [{...},
       {...}, {...}] }, { } }, {...}, {...}, ... ] }

Условия

Сайт вашей авиакомпании или онлайн-агентства должен позволять бронировать авиабилеты с моментальным подтверждением.

Сайт несет ответственность за корректность данных, соответствие предложений тематике, а также за распространение незаконной информации. В случае нарушения условий Яндекс имеет право не использовать данные сайта для изменения представления ответа в поисковой выдаче. См. подробные условия.

Чтобы стать партнером, оставьте заявку в форме ниже.

Дата обновления страницы: 16.01.2022.