Главная страница / Поиск рейсов

Поиск рейсов

Конечная точка:

GET /api/v1/offers

Параметры запроса:

  1. directions[*]departure_airportstring, обязательный. Пункт вылета, трёхбуквенный идентификатор IATA.
  2. directions[*]arrival_airportstring, обязательный. Пункт прибытия, трёхбуквенный идентификатор IATA.
  3. directions[*]datestring, обязательный. Дата вылета, в формате YYYY-MM-DD.
  4. service_classstring, обязательный. Класс обслуживания. Допустимые значения указаны в справочнике.
  5. adultsinteger, обязательный. Количество взрослых. Минимальное количество — 1.
  6. childreninteger, обязательный. Количество детей с местом от 2 до 12 лет. Минимальное количество — 0.
  7. infantsinteger, обязательный. Количество младенцев без места от 0 до 2 лет. Минимальное количество — 0.
  8. infants_with_seatinteger, обязательный. Количество младенцев с местом от 0 до 2 лет. Минимальное количество — 0.

Пример запроса OW (в одну сторону):

/api/v1/offers?directions[0][departure_airport]=TAS&directions[0][arrival_airport]=IST&directions[0][date]=2021-08-07&service_class=E&adults=2&children=0&infants=0&infants_with_seat=0

Пример запроса RT (перелет туда и обратно):

/api/v1/offers?directions[0][departure_airport]=TAS&directions[0][arrival_airport]=IST&directions[0][date]=2021-08-07&directions[1][departure_airport]=IST&directions[1][arrival_airport]=TAS&directions[1][date]=2021-08-16&service_class=E&adults=2&children=0&infants=0&infants_with_seat=0

Пример ответа:

{
    "request_id":"AhyUWPqIAXIXmdbJSIiqDvW3UHojAgqgrcEJ10K3",
    "created_at":"2021-04-08 09:59",
    "message":"The request was completed successfully.",
    "data":[
        {
            "id":"AExtfokS0hOv3wFdbiSuACSenrXNeWy1", // Идентификатор оффера. Используется при проверке наличия мест и цены перед бронированием, запроса правил тарифа, бронирования.
            "type": "AV", // Тип оффера.
            "is_charter": false, // Является ли оффер чартерным перелетом.
            "is_vtrip": false,
            "flight_type": "regular", // Тип оффера. Возможные варианты указаны в справочнике.
            "price":{
                "amount":6460717.33, // Общая стоимость оффера.
                "currency":"UZS" // Валюта, в которой указана общая стоимость, а также стоимость для каждого пассажира в блоке passengers.
            },
            "recommended_price":{
                "amount":8113913.13, // Стоимость, рекомендуемая перевозчиком для продажи конечному потребителю.
                "currency":"UZS" // Валюта, в которой указана рекомендуемая стоимость.
            },
            "transfers":false, // Наличие пересадок.
            "baggage":true, // Входит ли провоз багажа в стоимость.
            "refund":false, // Возможность возврата.
            "is_fare_family":true, // Доступность семейства тарифов.
            "fare_family_type":"ECONOMY SAVER", // Тип текущего тарифа.
            "fare_family_services":[ // Список услуг, которые входят в тариф.
                [
                    "Ручная кладь 8 кг/18 фунтов до 115 см/45 дюймов",
                    "Приоритетная посадка на рейс",
                ],
                ...
            ],
            "ticketing_time_limit":"2021-08-06 12:40:00", // Дата и время автоотмены, UTC.
            "passengers":[ // Информация о пассажирах и стоимости по каждому из них.
                {
                    "age":"adt", // Возрастная группа пассажира.
                    "price":4602952,
                },
                ...
            ],
            "documents":{
                "adt":[ // Возрастная группа пассажиров и перечень документов, которые могут быть использованы при бронировании.
                    "P",
                    "A"
                ],
                ...
            },
            "directions":[ // Направления перелетов. Например, в перелете Ташкент-Стамбул-Ташкент будет 2 направления: Ташкент-Стамбул и Стамбул-Ташкент.
                {
                    "departure":{
                        "datetime":"2021-08-07 07:40:00", // Дата и время вылета. Время местное.
                        "airport":{
                            "code":"TAS", // IATA код аэропорта.
                            "title":"Ислам Каримов", // Название аэропорта.
                            "title_intl":{
                                "uz":"Islom Karimov",
                                "en":"Islom Karimov",
                                "ru":"Ислам Каримов"
                            },
                            "city":"Ташкент", // Город.
                            "city_intl":{
                                "uz":"Toshkent",
                                "en":"Tashkent",
                                "ru":"Ташкент"
                            },
                            "country":{ // Страна.
                                "code":"UZ",
                                "title":"Узбекистан",
                                "title_intl":{
                                    "uz":"O'zbekiston",
                                    "en":"Uzbekistan",
                                    "ru":"Узбекистан"
                                }
                            }
                        }
                    },
                    "arrival":{
                        "datetime":"2021-08-07 11:00:00", // Дата и время прибытия. Время местное.
                        "airport":{
                            "code":"IST",
                            "title":"Новый",
                            "title_intl":{
                                "uz":null,
                                "en":"Istanbul",
                                "ru":"Новый"
                            },
                            "city":"Стамбул",
                            "city_intl":{
                                "uz":"Istanbul",
                                "en":"Istanbul",
                                "ru":"Стамбул"
                            },
                            "country":{
                                "code":"TR",
                                "title":"Турция",
                                "title_intl":{
                                    "uz":null,
                                    "en":"Turkey",
                                    "ru":"Турция"
                                }
                            }
                        }
                    },
                    "travel_time":320, // Время в пути, в минутах.
                    "transfer_time":null, // Время ожидания пересадки, в минутах.
                    "route_duration":452,
                    "segments":[ // Информация о рейсах оффера.
                        {
                            "departure":{
                                "datetime":"2021-08-07 07:40:00", // Дата и время вылета. Время местное.
                                "airport":{
                                    "code":"TAS", // IATA код аэропорта.
                                    "title":"Ислам Каримов", // Название аэропорта.
                                    "title_intl":{
                                        "uz":null,
                                        "en":"Islom Karimov",
                                        "ru":"Ислам Каримов"
                                    },
                                    "terminal":"2", // Название или код терминала.
                                    "city":"Ташкент", // Город.
                                    "city_intl":{
                                        "uz":"Toshkent",
                                        "en":"Tashkent",
                                        "ru":"Ташкент"
                                    },
                                    "country":{ // Страна.
                                        "code":"UZ",
                                        "title":"Узбекистан",
                                        "title_intl":{
                                            "uz":null,
                                            "en":"Uzbekistan",
                                            "ru":"Узбекистан"
                                        }
                                    }
                                }
                            },
                            "arrival":{
                                "datetime":"2021-08-07 11:00:00", // Дата и время прибытия. Время местное.
                                "airport":{
                                    "code":"IST",
                                    "title":"Новый",
                                    "title_intl":{
                                        "uz":null,
                                        "en":"Istanbul",
                                        "ru":"Новый"
                                    },
                                    "terminal":null,
                                    "city":"Стамбул",
                                    "city_intl":{
                                        "uz":"Istanbul",
                                        "en":"Istanbul",
                                        "ru":"Стамбул"
                                    },
                                    "country":{
                                        "code":"TR",
                                        "title":"Турция",
                                        "title_intl":{
                                            "uz":null,
                                            "en":"Turkey",
                                            "ru":"Турция"
                                        }
                                    }
                                }
                            },
                            "airline":{
                                "code":"HY", // IATA код авиакомпании-перевозчика.
                                "title":"Uzbekistan Airways" // Название авиакомпании-перевозчика.
                            },
                            "service_class":"E", // Класс обслуживания.
                            "flight_number":"271", // Номер рейса.
                            "seats":7, // Количество свободных мест.
                            "travel_time":320, // Время в пути, в минутах.
                            "transfer_time":null, // Время ожидания пересадки, в минутах.
                            "aircraft":"Boeing 787-800", // Название самолёта, выполняющего рейс.
                            "refund":false, // Возможность возврата.
                            "change":true, // Возможность обмена.
                            "handbags":{ // Информация о ручной клади.
                                "piece":1, // Количество мест.
                                "weight":8 // Максимальный вес.
                            },
                            "baggage":{ // Информация по багажу.
                                "piece":1, // Количество мест.
                                "weight":20 // Максимальный вес.
                            },
                            "comment":"Авиакомпания UZBEKISTAN AIRWAYS информирует ...", // Комментарий с описанием рейса.
                            "technical_stops":[ // Технические остановки.
                                {
                                    "airport":{
                                        "code":"SFO",
                                        "title":"San Francisco",
                                        "city":"Сан-Франциско",
                                        "country":"Соединенные Штаты"
                                    },
                                    "arrival_datetime":"2021-08-07 09:20:00",
                                    "departure_datetime":"2021-08-07 09:50:00",
                                    "duration":30 // Длительность остановки, в минутах.
                                }
                            ],
                            "information_for_clients":[ // Информация для клиентов.
                                {
                                    "uz":"Diqqat, loukoster!\nChipta toʼloʼvdan soʼng 4 soat ichida yoziladi.\nChipta umuman yozilmasligi ...",
                                    "en":"Attention, low-cost airline!\nThe ticket will be issued within 4 hours after payment.\nThere is a risk ...",
                                    "ru":"Внимание, лоукостер!\nБилет будет выписан в течение 4-х часов после оплаты.\nЕсть риск ..."
                                }
                            ]
                        },
                        ...
                    ]
                },
                ...
            ],
            "information_for_clients":[ // Информация для клиентов.
                {
                    "uz":"Diqqat, loukoster!\nChipta toʼloʼvdan soʼng 4 soat ichida yoziladi.\nChipta umuman yozilmasligi ...",
                    "en":"Attention, low-cost airline!\nThe ticket will be issued within 4 hours after payment.\nThere is a risk ...",
                    "ru":"Внимание, лоукостер!\nБилет будет выписан в течение 4-х часов после оплаты.\nЕсть риск ..."
                }
            ]
        },
        ...
    ]
}

Ограничения: