Портал разработчикаГостиничная система HMS

Подключайте своё ПО к модулям HMS

Отдельная документация API для каждого модуля гостиничной системы: модуль бронирования, гостевой Wi-Fi, ресторанный POS, спа, ТВ, АТС и ИИ-сервисы. API Online Booking и Hotspot уже доступны, остальные появятся следом.

Аутентификация
Bearer-токен или заголовок ApiKey
Формат
JSON-ответы в обёртке success
Доступно
2 продукта · 17 эндпоинтов
В разработке
5 продуктов
Запрос
# Запрос номеров и цен
curl "https://test.hms.gen.tr/external/online/roomType" \
  -H "Authorization: Bearer $HMS_TOKEN" \
  -d "hotelID=1000" -d "startDate=2026-08-18" -d "endDate=2026-08-20" \
  -d "adultCount=2"
Ответ · 200 (фрагмент)
{
    "success": true,
    "items": [
        {
            "id": 2,
            "name": "Стандартный номер",
            "roomCount": 5,
            "currency": "TRY",
            "accommodationTypes": [
                {
                    "id": 2,
                    "title": "Завтрак включён",
                    "prices": {
                        "2-1": {
                            "total": 2,
                            "price": "1930.00",
                            "nonRefundable": ""
                        },
                        "2-0": {
                            "total": 2,
                            "price": "1737.00",
                            "nonRefundable": "[NR]"
                        }
                    }
                }
            ]
        }
    ],
    "count": 1
}

Продукты

У каждого продукта своя документация, справочник API и примеры кода. О выходе новых продуктов мы сообщаем в истории изменений.

Доступно

Online Booking

API модуля бронирования

Подключает модуль бронирования на сайте отеля к HMS: список номеров и цен, доступность по календарю, купоны, оплата и передача бронирований.

8 ресурсов · 16 эндпоинтовДокументация
Доступно

Hotspot

Гостевой Wi-Fi и журналы по закону № 5651

Передаёт в систему хотспота список проживающих гостей: номер, личные данные, время заезда и выезда. Нужен для проверки входа гостей в Wi-Fi по номеру комнаты и ведения журналов доступа по закону Турции № 5651.

1 ресурс · 1 эндпоинтДокументация
В разработке

Ресторанный POS

Счета и начисления на номер

Перенос счетов ресторанов, баров и кафе на фолио номера, синхронизация меню и складских остатков.

Документация готовится
В разработке

Spa

Записи и продажа услуг

Записи на спа- и велнес-процедуры, каталог услуг и интеграция с начислением на номер.

Документация готовится
В разработке

ИИ

Ассистент и сервисы рекомендаций

Доступ к ИИ-сервисам для гостевого ассистента, рекомендаций по ценам и отчётности.

Документация готовится
В разработке

TV

ТВ-системы в номерах

Данные гостя, фолио, сообщения и заявки на услуги для ТВ-интерфейса в номере.

Документация готовится
В разработке

АТС

АТС и журнал звонков

Интеграция с телефонной станцией: включение и отключение линий при заезде и выезде, начисление стоимости звонков на фолио.

Документация готовится

Общие принципы для всех продуктов

Интегрировав один модуль, вы легко разберётесь и в остальных.

Ключ, привязанный к отелю

В Online Booking apiKey/apiSecret, выданные HMS, обмениваются на Bearer-токен, который привязан к отелю и действует 7 дней. Локальные интеграции, такие как Hotspot, используют ключ, созданный в панели самого отеля; он передаётся в заголовке ApiKey в каждом запросе.

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

Обёртка success

Ответы приходят в JSON и содержат поле success. Ошибки бизнес-логики возвращаются с HTTP 200 и полем message или errorCode; ошибки аутентификации — с кодом 401.

Запросы и ответы

Рабочие примеры

Для каждого эндпоинта генерируются примеры на cURL, Node.js и PHP: скопируйте, подставьте свой ключ и запустите.

Справочник API

Последние изменения

Вся история изменений

  • Сайт
    Поддержка 22 языков
    НовоеНовое
  • Hotspot
    Опубликована документация Hotspot API
    НовоеНовое
  • Online Booking
    Опубликована документация Online Booking API
    НовоеНовоеНовое

Возникли сложности?

Наша команда разработчиков отвечает в течение одного рабочего дня.

Приложите тело запроса (скрыв секреты и данные карт), ответ и время. По этому же адресу запрашивайте ключи партнёра, тестовые отели и ранний доступ.