Главная страница / Запрос информации по бронированию
Используйте этот метод, чтобы обновить статус бронирования. Например, после оплаты вы чаще всего получаете статус paid, который означает, что оплата прошла успешно. А конечным статусом корректно выписанного билета является ticketed, который будет назначен спустя какое-то время после выполнения всех формальностей, что может занять около 10 минут. Этот метод позволит обновить данные бронирования для получения финального статуса.
Также этот метод позволяет получить номера билетов для пассажиров. Номер билета будет назначен после оплаты.
Конечная точка:
GET /api/v1/booking/{id}
Параметры запроса:
Пример запроса
/api/v1/booking/A5kucCKZjhN9iZyKE117307Cqqz2jOEw
Пример ответа:
{
"request_id":"gLLEfxGC3Rd8M3xeALmlF8LIOIau92ylzLPh2hvM",
"created_at":"2021-04-12 15:15",
"message":"The request was completed successfully.",
"data":{
"id":"A5kucCKZjhN9iZyKE117307Cqqz2jOEw", // Идентификатор бронирования. Используется при запросе правил тарифа, оплате.
"type": "AV", // Тип оффера.
"status":"booked", // Статус бронирования.
"created":"2021-04-12 15:15:41", // Дата и время создания, UTC.
"expire":"2021-04-15 15:05:00", // Дата и время автоотмены, UTC.
"refund_availability":true, // Флаг наличия возврата.
"is_charter": false, // Является ли оффер чартерным перелетом.
"flight_type": "regular", // Тип оффера. Возможные варианты указаны в справочнике.
"price":{
"has_changed":false, // Будет true, если стоимость бронирования изменилась.
"prev_amount":null, // Стоимость до последнего изменения.
"amount":3248609, // Общая стоимость бронирования.
"currency":"UZS" // Валюта, в которой указана общая стоимость, а также стоимость для каждого пассажира в блоке passengers.
},
"payer":{
"name":"Viktor Petrov", // Имя плательщика.
"email":"developer@bookhara.com", // Email плательщика.
"tel":"+380 65 214-75-02" // Номера телефона плательщика.
},
"passengers":[ // Данные пассажиров.
{
"key":"48304083", // Идентификатор пассажира.
"first_name":"Alla", // Имя пассажира.
"last_name":"Petrova", // Фамилия пассажира.
"middle_name":null, // Отчество пассажира.
"email":"developer@bookhara.com", // Email пассажира.
"tel":"+998565004522", // Номера телефона пассажира.
"gender":"F", // Пол пассажира.
"birthdate":"1983-01-06", // Дата рождения пассажира, в формате YYYY-MM-DD.
"citizenship":"UZ", // Гражданство пассажира.
"age":"adt", // Возрастная группа пассажира.
"document":{ // Данные документа для оформления бронирования
"type":"A", // Тип документа.
"number":"AS76123646", // Номер документа.
"expire":"2023-05-14" // Срок действия документа, в формате YYYY-MM-DD.
},
"price":3248609,
"extended_price":{
"has_changed":false, // Будет true, если стоимость бронирования изменилась.
"prev_amount":null, // Стоимость до последнего изменения.
"amount":3248609, // Стоимость для пассажира.
},
"tickets":[ // Билеты пассажира.
{
"pnr":"0MSBMG", // PNR.
"airline_locators":[ // Локатор авиакомпании, используется для регистрации на рейс.
"TK\/UNESYV"
],
"ticket_number":"7342625471232", // Номер билета.
"carrier":{
"code":"HY",
"title":"Uzbekistan Airways"
},
"provider":"TUA"
},
...
],
"itinerary_receipt":"https://bookhara.uz/pdf-receipts/2fraad5f-5fa1-3a38-a5ef-63bde34b0ed8_1624_GULOMJON_TULANBAEV_1993-02-16.pdf", // Ссылка на маршрутную квитанцию.
"additional_baggage":[]
},
...
],
"directions":[ // Направления перелетов.
{
"departure":{
"datetime":"2021-09-03 08:50:00", // Дата и время вылета. Время местное.
"airport":{
"code":"TAS", // IATA код аэропорта.
"title":"Ислам Каримов", // Название аэропорта.
"title_intl":{
"uz":null,
"en":"Islom Karimov",
"ru":"Ислам Каримов"
},
"city":"Ташкент", // Город.
"city_intl":{
"uz":"Toshkent",
"en":"Tashkent",
"ru":"Ташкент"
},
"country":{ // Страна.
"code":"UZ",
"title":"Узбекистан",
"title_intl":{
"uz":null,
"en":"Uzbekistan",
"ru":"Узбекистан"
}
}
}
},
"arrival":{
"datetime":"2021-09-03 12:05: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":315, // Время в пути, в минутах.
"transfer_time":null, // Время ожидания пересадки, в минутах.
"route_duration":315,
"segments":[ // Информация о рейсах оффера.
{
"departure":{
"datetime":"2021-09-03 08:50: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-09-03 12:05: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":"TK", // IATA код авиакомпании-перевозчика.
"title":"Turkish Airlines" // Название авиакомпании-перевозчика.
},
"service_class":"E", // Класс обслуживания.
"flight_number":"369", // Номер рейса.
"travel_time":315, // Время в пути, в минутах.
"transfer_time":null, // Время ожидания пересадки, в минутах.
"aircraft":"Airbus A320-100/200", // Название самолёта, выполняющего рейс.
"refund":true, // Возможность возврата.
"change":true, // Возможность обмена.
"handbags":{ // Информация о ручной клади.
"piece":1, // Количество мест.
"weight":8 // Максимальный вес.
},
"baggage":{ // Информация по багажу.
"piece":1,
"weight":35
},
"comment":"",
"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Есть риск ..."
}
]
}
}
Используйте этот метод, чтобы обновить статус бронирования. Например, после оплаты вы чаще всего получаете статус paid, который означает, что оплата прошла успешно. А конечным статусом корректно выписанного билета является ticketed, который будет назначен спустя какое-то время после выполнения всех формальностей, что может занять около 10 минут. Этот метод позволит обновить данные бронирования для получения финального статуса.
Также этот метод позволяет получить номера билетов для пассажиров. Номер билета будет назначен после оплаты.