Операции API#

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

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

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

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

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

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

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

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

Авиа#

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

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

Отели#

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

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

Справочники#

GET-методы Dictionary API со статической и справочной информацией:

• Статическая информация по отелю — карточка отеля по hotelId
• Справочники — страны, города, типы объектов размещения, услуги, типы кроватей, типы питания

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

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

Операции авиа и отелей принимают JSON через POST, справочники работают по GET с параметрами в URL. Единого набора обязательных полей нет: состав и обязательность параметров индивидуальны для каждой операции и описаны на её странице. Поставщик и офис в запросе не передаются, их выбирает сервис по настроенным пресетам клиента.

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

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

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

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

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

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

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