Интеграция Inn-Book с OTA через API

Или выберите из списка:

Интеграция с OTA через API

Требования к каналу продаж (OTA)

Для подключения к системе Inn-Book каналу продаж (OTA) необходимо поддерживать собственный Online Booking Engine (OBE) — механизм, включающий следующие функции:

🔍 Поиск отелей и тарифов
📝 Создание и отмена бронирований
📦 Хранение актуальных справочников (геоданные, отели, номера, тарифы и пр.)

Архитектура API

Интеграция строится на взаимодействии двух сторон:

API на стороне OTA — для получения обновлений и отправки сопоставлений
API на стороне Inn-Book — для доступа к информации о номерах, ценах и доступности

📡 Два способа приёма обновлений:

Socket API (TCP) — подключение к сокет серверу позволяет получать уведомления в реальном времени
Webhook — механизм уведомления OTA по URL

API на стороне OTA

Сторона OTA должна реализовать следующие методы:

Получение и передача категорий размещений и тарифов
Обработка уведомлений о смене цен, ограничений, доступности
Сопоставление объектов между системами OTA и Inn-Book
Подтверждение и аннуляция бронирований

API на стороне Inn-Book

Inn-Book предоставляет REST API для доступа к информации отеля:

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

📎 Полезные ссылки:

📋 Обзор методов API Inn-Book ↔ OTA

I. API на стороне OTA (вызовы от Inn-Book)

Метод	Назначение	Комментарий
getConnect	Запрос на соединение с OTA	Используется при первичном подключении отеля
getAuth	Авторизация отеля в системе OTA	По ID и ключу отеля
getRooms	Получение списка номеров и тарифов	Отправляется Inn-Book при маппинге
createMatching	Сопоставление ID тарифов/номеров	Сохраняется в Inn-Book
cancelIntegration	Отключение интеграции	Удаление отеля из системы OTA
availabilityUpdate	Обновление доступности	Отправка JSON по категориям и датам
priceUpdate	Обновление цен	Передача цен по категориям
hotelUpdate	Обновление информации об отеле	Описание, контакты, фото
updateBooking	Уведомление о изменении/отмене брони	От Inn-Book к OTA

II. REST API Inn-Book (вызовы от OTA)

Метод	Назначение	Комментарий
Authorization	Аутентификация API-запросов	Заголовок Authorization: API_KEY
getHotelInfo	Общая информация об отеле	Название, адрес, описание
getAvailability	Получение доступности	По категориям и датам
getPrices	Получение цен	Сетка цен по категориям
createBooking	Создание брони	Передача брони от OTA в Inn-Book
updateBooking	Изменение или отмена брони	Обновление данных бронирования

III. Socket API Inn-Book (Push-уведомления по сокету)

Тип события	Назначение	Комментарий
type: auth	Запрос авторизации по ключу	Ответ OTA: {"act": "auth", "key": "..."}
type: ping	Проверка соединения	Ответ OTA: {"act": "pong"}