Цены отеля (Hotel Pricing)#

Получение всех доступных предложений для конкретного отеля.

Описание#

Эндпоинт: POST /api/hotels/hotel_pricing

Возвращает полный список доступных номеров и тарифов для выбранного отеля с детальной ценовой информацией. В ответе возвращается searchId, который используется для проверки цены и создания бронирования.

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

Используйте этот запрос после выбора отеля из результатов поиска для получения всех вариантов номеров.

Основной сценарий#

Получите hotelId из результатов поиска
Отправьте запрос с hotelId, датами и гостями
Получите список предложений с детальными ценами
Выберите подходящее предложение (offerId)
Проверьте цену через /api/hotels/offer_pricing

Базовый пример#

Минимальный запрос:

 1{
 2  "hotelId": "hotel-001",
 3  "checkin": "2025-12-15",
 4  "checkout": "2025-12-18",
 5  "currency": "RUB",
 6  "onlyAvailableOffers": true,
 7  "guests": {
 8    "adults": 2
 9  }
10}

Ответ содержит:

1{
2  "hotelId": "hotel-001",
3  "checkinDate": "2025-12-15",
4  "checkoutDate": "2025-12-18",
5  "searchId": "search-xyz789",
6  "offers": [ /* список предложений */ ]
7}

Детальная документация#

Параметры запроса — полное описание всех параметров и примеры использования
Структура ответа — детальное описание структуры ответа

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

Код ошибки	Причина	Решение
`INVALID_HOTEL_ID`	Неверный формат `hotelId`	Проверьте формат переданного `hotelId`
`HOTEL_MAPPING_NOT_FOUND`	Отель не сопоставлен ни с одним поставщиком	Проверьте корректность `hotelId`
`NO_MATCHING_SEARCH_PRESET`	Ни один настроенный пресет поиска не подходит под параметры запроса	Измените параметры запроса или проверьте пресеты в личном кабинете
`NO_SEARCH_PRESETS_CONFIGURED`	Для клиента не настроен ни один пресет поиска	Настройте пресет поиска в личном кабинете
`VALIDATION_ERROR`	Ошибка валидации запроса (HTTP 400)	Проверьте обязательные поля и форматы значений
`NO_TARGETS`	Под запрос не нашлось ни одного поставщика: ни один не настроен либо все отсеяны на этапе подготовки запроса	Проверьте настройки офисов и пресетов в личном кабинете; при сохранении ошибки обратитесь в поддержку
`SUPPLIER_ERROR`	Поставщик вернул ошибку. Причина — текстом поставщика в поле `message`	Разберите `message`; при необходимости повторите запрос позже
`SYSTEM_ERROR`	Внутренняя ошибка Travel API	Повторите запрос позже; при повторении обратитесь в поддержку с `errorId`

Помимо перечисленных TAPI-кодов, при ошибке на стороне поставщика в ответе может быть возвращён код ошибки поставщика без изменений (проброс) — набор таких кодов зависит от поставщика и не фиксирован.

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

Поиск отелей — поиск отелей по региону
Проверка цены — верификация цены перед бронированием
Создание бронирования — бронирование номера