Цены отеля (Hotel Pricing)#
Получение всех доступных предложений для конкретного отеля.
Описание#
Эндпоинт: POST /hotels/hotel_pricing
Возвращает полный список доступных номеров и тарифов для выбранного отеля с детальной ценовой информацией. В ответе возвращается searchId, который используется для проверки цены и создания бронирования.
Использование#
Используйте этот запрос после выбора отеля из результатов поиска для получения всех вариантов номеров.
Основной сценарий#
- Получите
hotelIdиз результатов поиска - Отправьте запрос с
hotelId, датами и гостями - Получите список предложений с детальными ценами
- Выберите подходящее предложение (
offerId) - Проверьте цену через
/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}Детальная документация#
- Параметры запроса — полное описание всех параметров и примеры использования
- Структура ответа — детальное описание структуры ответа
Типичные ошибки#
| Код ошибки | Причина | Решение |
|---|---|---|
HOTEL_NOT_FOUND | Отель не найден | Проверьте hotelId |
NO_AVAILABILITY | Нет доступных номеров | Измените даты или параметры |
Связанные операции#
- Поиск отелей — поиск отелей по региону
- Проверка цены — верификация цены перед бронированием
- Создание бронирования — бронирование номера