Метод getRooms
📌 Описание
Метод используется для получения от OTA информации о доступных категориях номеров и тарифах, которые могут быть сопоставлены с объектами в системе Inn-Book.
⚠️ Важно
Метод не содержит данных в объекте data.
🎯 Назначение
Метод вызывается для получения списка номеров и тарифов, зарегистрированных в OTA, с целью дальнейшего создания сопоставлений (matching) между Inn-Book и OTA.
📤 Пример запроса
{
"auth": {},
"action": "get_rooms",
"data": {}
}
🔎 Пояснение к параметрам запроса
| Поле | Тип | Описание |
|---|---|---|
| auth | object | Объект авторизации/идентификации отеля |
| action | string | Название метода (get_rooms) |
| data | object | Пустой объект данных |
📥 Пример ответа OTA
{
"rooms": [
{
"id": "5",
"name": "Трехместный стандарт",
"seats": "3",
"idInnBook": "94"
}
],
"rates": [
{
"id": "253",
"name": "Без завтрака",
"idInnBook": "45"
}
],
"status": "ok"
}
🧾 Пояснение к полям ответа
📦 Основные массивы
| Поле | Описание |
|---|---|
| rooms | Список категорий номеров, зарегистрированных в OTA |
| rates | Список тарифов, зарегистрированных в OTA |
| status | Статус выполнения запроса |
🏷 Поля объектов rooms и rates
| Поле | Описание |
|---|---|
| id | Уникальный идентификатор номера/тарифа в системе OTA |
| name | Название категории номера или тарифа |
| seats | Количество мест в категории номера (только для rooms) |
| idInnBook | ID соответствующего объекта в Inn-Book, если сопоставление уже выполнено; null — если сопоставления нет |
🔗 Логика сопоставления (Matching)
После получения ответа:
- OTA передает список своих категорий номеров и тарифов
- Система Inn-Book выполняет сопоставление с внутренними объектами
- При успешном сопоставлении в поле
idInnBookпередается соответствующий ID - Если сопоставление отсутствует — возвращается
null
🔐 Рекомендации по реализации на стороне OTA
Рекомендуется
- Передавать полный актуальный список номеров и тарифов
- Сохранять неизменность
idдля корректного matching - Возвращать единый формат ответа с обязательным полем
status