REST API · OpenAPI 3.0 · JSON

Hotel OS2 API

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

Base URL

https://195.35.56.63

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

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://195.35.56.63/api/book/lazurnyy/check?checkIn=2026-06-01&checkOut=2026-06-05&adults=2"

# Создать бронирование
curl -X POST "https://195.35.56.63/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
  }'

Официальные SDK

JavaScript / TypeScript

npm install @hotelos2/sdk

Python

pip install hotelos2

PHP

composer require hotelos2/sdk

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

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

partner_ota@hotelos2.ru