Авиабилеты
Это старая версия документа, которая прекратила свое действие 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 | Буквенное обозначение класса обслуживания. Допустимые значения:
|
adults | Количество пассажиров старше 12 лет. |
children | Количество пассажиров от 2 до 12 лет (включительно). Может отсутствовать. |
infants | Количество детей до 2 лет (включительно). Может отсутствовать. |
departure | Код аэропорта отправления. Указывается код IATA или код в системе «Сирена-Трэвел». |
arrival | Код аэропорта прибытия. Указывается код IATA или код в системе «Сирена-Трэвел». |
date_forward | Дата прямого вылета в формате YYYY-MM-DD. |
date_backward | Дата обратного вылета в формате YYYY-MM-DD. Может отсутствовать. |
class | Буквенное обозначение класса обслуживания. Допустимые значения:
|
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 | Количество оставшихся мест по данной цене. | Число |
Поле | Описание | Формат |
---|---|---|
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) |
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) |
Baggage | ||
---|---|---|
included * | Наличие возможности без дополнительной оплаты провезти сдаваемый багаж. | Логический |
pieces * | Число мест багажа. | Число |
weight * | Вес багажа. | Число |
units * | Единицы изменения веса. | Строка |
dimensions | Объект, включающий поля с информацией о допустимых размерах багажа. | Объект (Dimensions) |
Dimensions | ||
---|---|---|
length | Длина. | Число |
width | Ширина. | Число |
height | Высота. | Число |
sum | Сумма длины, ширины и высоты. | Число |
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.