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

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

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

Детальное описание всех параметров для запроса /avia/fare_rules.

Обязательные параметры#

Параметр	Тип	Описание
`searchId`	string	Идентификатор из `/avia/search`
`offerItemId`	string	Идентификатор предложения для получения правил

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

curl

1curl -X POST https://test.travel-api.ru/avia/fare_rules \
2 -H "Authorization: Bearer YOUR_TOKEN" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "searchId": "0E8AC7882BECA40467A7047BEDCE3FEC",
6 "offerItemId": "571B2E9333EA93F9365BB4FB0C1492A2"
7 }'

Типичные ошибки#

Код ошибки	Причина	Решение
`SEARCH_EXPIRED`	Поиск устарел	Выполните новый поиск
`OFFER_NOT_AVAILABLE`	Предложение недоступно	Выберите другое предложение
`INVALID_OFFER_ITEM_ID`	Некорректный ID	Проверьте offerItemId

Связанные операции#

Поиск рейсов - получение searchId и offerItemId
Проверка цены - проверка актуальной цены предложения
Создание бронирования - создание PNR после проверки правил

Структура ответа

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

Структура ответа#

Детальное описание структуры ответа от /avia/fare_rules.

Основная структура#

Ответ содержит массив правил для запрошенного предложения.

Поле	Тип	Описание
`rules`	array	Массив правил тарифа

Структура Rule#

Каждый элемент массива rules содержит:

Поле	Тип	Описание
`fareBasis`	string	Код базового тарифа
`ticketDesignator`	string	Дескриптор билета
`categories`	array	Массив категорий правил

Структура RuleCategory#

Каждая категория содержит:

Поле	Тип	Описание
`category`	string	Номер категории (от 0 до 33)
`caption`	string	Название категории на русском языке
`text`	string	Детальное описание правил категории

Примеры ответов#

Успешный ответ#

 1{
 2 "rules": [
 3 {
 4 "fareBasis": "ILTOW",
 5 "categories": [
 6 {
 7 "category": "0",
 8 "caption": "Применение",
 9 "text": "НАЗВАНИЕ УПТ - ТАРИФЫ ГРУППЫ SMART LIGHT\nДАННЫЕ ТАРИФЫ ПРИМЕНЯЮТСЯ ДЛЯ ЭКОНОМИЧЕСКОГО КЛАССА ОБСЛУЖИВАНИЯ..."
10 },
11 {
12 "category": "5",
13 "caption": "Бронирование и оформление билета",
14 "text": "Бронирование разрешается не позднее чем за 7 сут до отправления воздушного судна..."
15 },
16 {
17 "category": "16",
18 "caption": "Сборы при расторжении договора",
19 "text": "ДОБРОВОЛЬНОЕ ИЗМЕНЕНИЕ УСЛОВИЙ ДОГОВОРА ПЕРЕВОЗКИ РАЗРЕШАЕТСЯ..."
20 }
21 ]
22 }
23 ]
24}

Структура с несколькими базовыми тарифами#

Если предложение содержит несколько участков с разными тарифами:

Правила тарифа on Travel API - Документация