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 может использовать полученные данные для:
- создания категорий номеров и тарифов, которых ещё нет в её системе
- обновления фотографий и услуг;
- формирования вариантов размещения с ценой по умолчанию.
Варианты размещения формируются по связке: категория номера + тариф + число гостей.