Общие типы данных on Travel API - Документация

Локации

Mon, 01 Jan 0001 00:00:00 +0000

Локации#

Типы для работы с географическими точками (аэропорты, города).

Location#

Географическая точка — аэропорт или город.

Поле	Тип	Обязательно	Описание
`code`	string	Да	Код аэропорта или города (3 буквы)
`codeType`	LocationCodeType	Да	Тип кода
`type`	LocationType	Да	Тип локации

Примеры#

Аэропорт Шереметьево:

1{
2 "code": "SVO",
3 "codeType": "iata",
4 "type": "airport"
5}

Город Москва:

1{
2 "code": "MOW",
3 "codeType": "iata",
4 "type": "city"
5}

Использование#

Используется для указания:

Пассажиры

Mon, 01 Jan 0001 00:00:00 +0000

Пассажиры#

Типы для работы с информацией о пассажирах.

PassengerType#

Тип пассажира по возрастной категории.

Возможные значения#

Значение	Описание	Возраст
`adt`	Взрослый (Adult)	12+ лет
`chd`	Ребенок (Child)	2-11 лет
`inf`	Младенец (Infant)	0-2 года

Примеры#

1"ptc": "adt"

Особенности#

Младенец (inf) обычно не занимает отдельное место
Ребенок (chd) занимает отдельное место
Цены различаются по типам пассажиров

PassengerTypeQuantity#

Количество пассажиров определенного типа.

Поле	Тип	Обязательно	Описание
`ptc`	PassengerType	Да	Тип пассажира
`quantity`	integer	Да	Количество пассажиров данного типа (1-9)

Примеры#

2 взрослых:

Рейсы

Mon, 01 Jan 0001 00:00:00 +0000

Рейсы#

Типы для описания авиарейсов.

FlightDesignator#

Обозначение рейса — комбинация кода авиакомпании и номера рейса.

Поле	Тип	Обязательно	Описание
`carrierCode`	string	Да	Код авиакомпании (IATA, 2 буквы)
`flightNumber`	string	Нет	Номер рейса

Примеры#

Рейс Аэрофлота SU 1234:

1{
2 "carrierCode": "SU",
3 "flightNumber": "1234"
4}

Рейс S7 Airlines S7 5:

1{
2 "carrierCode": "S7",
3 "flightNumber": "5"
4}

Использование#

marketingCarrier — авиакомпания, продающая билет
operatingCarrier — авиакомпания, фактически выполняющая рейс (может отличаться при codeshare)
preferredFlights — предпочитаемые рейсы при поиске

FlightType#

Тип рейса.

Багаж

Mon, 01 Jan 0001 00:00:00 +0000

Багаж#

Типы для описания норм багажа.

BaggageAllowance#

Норма багажа для тарифа.

Поле	Тип	Обязательно	Описание
`type`	BaggageType	Да	Тип багажа
`pieceAllowance`	PieceAllowance	Нет	Норма по количеству мест
`weightAllowance`	WeightAllowance	Нет	Норма по весу

Примечание: Указывается либо pieceAllowance, либо weightAllowance в зависимости от типа нормы.

BaggageType#

Тип багажа.

Возможные значения:

carryOn — ручная кладь
checked — зарегистрированный багаж

PieceAllowance#

Норма багажа по количеству мест (PC concept).

Поле	Тип	Обязательно	Описание
`totalPieces`	integer	Да	Количество мест багажа
`weightPerPiece`	Weight	Нет	Вес одного места
`dimensions`	Dimensions	Нет	Размеры багажа

WeightAllowance#

Норма багажа по весу (weight concept).

Тарифы

Mon, 01 Jan 0001 00:00:00 +0000

Тарифы#

Типы для работы с тарифами и классами обслуживания.

CabinType#

Класс обслуживания в самолете.

Возможные значения#

Значение	Описание	Буквенный код
`economy`	Эконом класс	Y
`premiumEconomy`	Премиум эконом	W
`business`	Бизнес класс	C
`first`	Первый класс	F

Примеры#

1"cabin": "business"

Использование#

В поиске для ограничения класса обслуживания:

1{
2 "searchCriteria": {
3 "fareConstraints": {
4 "cabin": "business"
5 }
6 }
7}

TariffType#

Вид тарифа по условиям доступа.

Таксы и сборы

Mon, 01 Jan 0001 00:00:00 +0000

Таксы и сборы#

Типы для работы с таксами и сборами.

Taxes#

Структура такс с разбивкой по видам.

Поле	Тип	Обязательно	Описание
`total`	MonetaryAmount	Да	Общая сумма такс
`breakdown`	TaxBreakdown[]	Нет	Разбивка по видам такс

TaxBreakdown#

Детализация таксы по коду.

Поле	Тип	Обязательно	Описание
`code`	string	Да	Код таксы (YQ, YR, и т.д.)
`amount`	MonetaryAmount	Да	Сумма

Примеры кодов такс#

Наиболее распространенные коды такс:

YQ — топливный сбор авиакомпании
YR — сбор за обслуживание в аэропорту
XT — прочие сборы
RU — российские сборы

Пример#

 1{
 2 "total": {
 3 "currencyCode": "RUB",
 4 "value": 1300
 5 },
 6 "breakdown": [
 7 {
 8 "code": "YQ",
 9 "amount": {
10 "currencyCode": "RUB",
11 "value": 1000
12 }
13 },
14 {
15 "code": "YR",
16 "amount": {
17 "currencyCode": "RUB",
18 "value": 300
19 }
20 }
21 ]
22}