hotelinfo Получение полной информации об отеле, номерах, тарифах и вариантах размещения
URL: https://restota.inn-book.com/v1/rhotelinfo Метод: POST Назначение: Получение структурированных данных об отеле, необходимых для формирования предложений на стороне OTA.
⚠️ Важно: если отель не добавил OTA как канал продаж в своём личном кабинете InnBook — запрос завершится ошибкой.
Метод предназначен для: - Создания вариантов размещения на стороне OTA на основе данных отеля в InnBook. - Получения полной информации об отеле: номера, тарифы, услуги, фотографии. - Используется OTA для построения или обновления контентной базы (категории номеров, тарифы, фотографии и др.).
Запрос:
{
"hid": 455221 // ID отеля в системе InnBook
}
{
"hotel": { // информация об отеле
"name": "Тестовый отель", // название отеля
"typeId": "Гостиница", // тип отеля (гостиница, хостел, апартаменты и т.д.)
"stars": 0, // звездность отеля
"address": { // объект адреса отеля
"index": "", // почтовый индекс
"street": "", // улица
"numHouse": 1, // номер дома
"corpus": 1, // корпус (если есть)
"building": 1 // строение (если есть)
},
"coordinates": { // координаты отеля
"lat": "54.5568008", // широта
"lon": "36.2997017" // долгота
},
"checkOutTime": "12:00", // время выезда
"checkInTime": "14:00", // время заезда
"photos": [ // массив ссылок на фотографии отеля
"https://inn-book.com/images/hotels/37706/16ab7c2ed3bcf61fd30882c60301e3bb.jpg"
],
"facilities": [ // массив удобств/услуг отеля
"Уличная парковка"
]
},
"rates": [ // массив тарифов
{
"id": 20, // ID тарифа
"name": "Без завтрака", // название тарифа
"food": { // схема питания
"breakfast": 0, // завтрак включен (1 — да, 0 — нет)
"lunch": 0, // обед включен
"dinner": 0 // ужин включен
},
"close_s": 0, // закрыт для продажи (1 — да, 0 — нет)
"date_start": null, // дата начала действия тарифа
"date_stop": null, // дата окончания действия тарифа
"min_dey": 0, // минимальное количество дней для бронирования
"max_dey": 0, // максимальное количество дней для бронирования
"pay_online": 0 // 1 — невозвратный тариф, требует онлайн-оплаты; 0 — обычный
}
],
"room": [ // массив категорий номеров
{
"id": 49, // ID категории номера
"name": "Стандарт", // название категории
"count": 3, // общее количество номеров данной категории
"seats": 2, // количество основных мест в номере
"area": 10, // площадь номера в квадратных метрах
"extSeats": 0, // количество дополнительных мест
"beds": "2", // описание спальных мест (например, "1+1" или "2")
"facilities": [ // удобства в номере
"Wi-fi"
],
"photo": [ // массив ссылок на фотографии номера
"https://inn-book.com/images/hotels/37706/16ab7c2ed3bcf61fd30882c60301e3bb.jpg"
],
"varint": [ // массив вариантов размещения (комбинация номер + тариф + количество гостей)
{
"rates_id": 20, // ID тарифа
"seats": 2, // количество гостей по варианту
"default_price": "800.00" // базовая цена без скидок и наценок
}
]
}
]
}
💡 Примечания Метод часто используется OTA в качестве контентного API. OTA может использовать полученные данные для: - создания категорий номеров и тарифов, которых ещё нет в её системе - обновления фотографий и услуг; - формирования вариантов размещения с ценой по умолчанию. Варианты размещения формируются по связке: категория номера + тариф + число гостей.