REST API · OpenAPI 3.0 · JSON

Hotel OS2 API

Полная документация REST API для встройки бронирования и интеграции с внешними системами.

Base URL

https://hotelos2.ru

Аутентификация

Bearer JWT-token

Формат

application/json

Основные endpoints

GET/api/book/{slug}Информация об отеле и список номеровpublic

GET/api/book/{slug}/checkПроверка доступности номеров на датыpublic

POST/api/book/{slug}/reserveСоздание бронирования (защита от race-conditions)public

GET/api/book/{slug}/snippetHTML-код виджета бронирования для встройкиpublic

GET/api/bookingsСписок бронирований отеля

POST/api/bookingsСоздание брони из админки

GET/api/roomsСписок номеров

POST/api/roomsДобавить номер (проверка лимита плана)

GET/api/guestsБаза гостей

GET/api/reports/occupancyОтчёт по загрузке

POST/api/webhooks/channels/{provider}Приём обновлений от каналов продаж

Пример запроса

# Получить список номеров отеля lazurnyy на даты
curl -X GET "https://hotelos2.ru/api/book/lazurnyy/check?checkIn=2026-06-01&checkOut=2026-06-05&adults=2"

# Создать бронирование
curl -X POST "https://hotelos2.ru/api/book/lazurnyy/reserve" \
  -H "Content-Type: application/json" \
  -d '{
    "roomId": "room_123",
    "checkIn": "2026-06-01",
    "checkOut": "2026-06-05",
    "guestName": "Иван Петров",
    "guestPhone": "+7 (923) 891-45-56",
    "guestEmail": "ivanov@example.com",
    "adults": 2,
    "children": 0
  }'

Как обращаться к API

Готовых библиотек под конкретные языки пока нет — они в планах. Сейчас API вызывается напрямую по HTTP, это работает из любого языка.

# Доступность номеров — публичный метод, токен не нужен
curl "https://hotelos2.ru/api/book/lazurnyy/check?checkIn=2026-10-01&checkOut=2026-10-05&adults=2"

# Список бронирований отеля — нужен токен из личного кабинета
curl "https://hotelos2.ru/api/bookings" \
  -H "Authorization: Bearer <ваш токен>"

Токен доступа выпускается в личном кабинете. Нужна помощь с интеграцией — напишите нам, поможем с примерами под ваш стек.

Нужна помощь с интеграцией?

Напишите нам, мы поможем подключиться к Hotel OS2 за 1-2 дня.

nadezhdin@ro.ru