REST API · JSON

REST API Hotel OS2 для интеграции с PMS

Основные методы 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База гостей

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

# Получить список номеров отеля 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",
    "guest": {
      "firstName": "Иван",
      "lastName": "Петров",
      "phone": "+7 (923) 891-45-56",
      "email": "ivanov@example.com"
    },
    "adults": 2,
    "children": 0,
    "consent": true
  }'

Как обращаться к 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 <ваш токен>"

Для закрытых методов нужен токен входа сотрудника отеля — он действует ограниченное время. Постоянные ключи API для внешних систем и полное описание в формате OpenAPI — в разработке. Нужна помощь с интеграцией — напишите нам.

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

Напишите нам — оценим задачу и назовём срок.

info@hotelos2.ru