Операции с отелями#

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

Категории операций#

Статика#

• Статическая информация по отелю — получение справочных данных по отелю

Поиск и ценообразование#

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

• Поиск отелей — поиск доступных отелей в регионе
• Цены отеля — получение всех предложений для конкретного отеля
• Проверка цены предложения — верификация актуальной цены перед бронированием

Бронирование#

Создание и управление бронированиями:

• Создание бронирования — бронирование выбранного номера
• Просмотр бронирования — получение деталей бронирования
• Поиск бронирований — поиск существующих бронирований
• Отмена бронирования — отмена бронирования

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

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

Все операции принимают JSON и требуют авторизации через Bearer-токен.

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

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

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

Сжатие ответов#

API поддерживает сжатие ответов. Чтобы получить сжатый ответ, передайте заголовок Accept-Encoding с желаемым алгоритмом:

Accept-Encoding: br
Accept-Encoding: gzip
Accept-Encoding: br, gzip

Поддерживаемые алгоритмы: br (Brotli), gzip.

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

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

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