Операции API#

Travel API предоставляет набор операций для работы с различными видами транспорта и услуг. Все операции используют метод POST и возвращают JSON.

Доступные категории#

Общие типы данных#

Справочник общих типов данных, используемых в различных операциях API:

• Денежные операции, локации, пассажиры
• Рейсы, багаж, тарифы
• Системные типы

Аутентификация#

Операции для получения доступа к API:

• Получение токена — аутентификация и получение JWT токена доступа

Авиа#

Операции для работы с авиабилетами:

• Поиск и ценообразование — поиск предложений, проверка цен, правила тарифов
• Бронирование — создание и управление бронированиями (PNR)
• Выписка и управление билетами — выписка, обмен, возврат билетов

Отели#

Операции для работы с бронированием отелей:

• Поиск и ценообразование — поиск отелей, получение цен, проверка предложений
• Бронирование — создание, просмотр, поиск и отмена бронирований

Общие принципы#

Формат запросов#

Все операции принимают JSON и требуют указания:

• officeId — идентификатор офиса
• supplier — код поставщика

HTTP метод и заголовки#

Формат ответов#

Каждый ответ может содержать:

• Данные операции (зависит от типа)
• Опциональное поле error при наличии ошибки

Обработка ошибок#

При возникновении ошибки ответ содержит объект error:

1{
2  "error": {
3    "code": "ERROR_CODE",
4    "message": "Описание ошибки",
5    "description": "Детальное описание"
6  }
7}