Подключайте своё ПО к модулям 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"# Список проживающих гостей
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
-H "ApiKey: $HMS_API_KEY" \
-H "HotelCode: 1000"{
"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
}{
"success": 1,
"otelde": [
{
"unique": 58211,
"firstName": "AYŞE",
"lastName": "DEMİR",
"identityNumber": "11111111110",
"birthDate": "14.03.1985",
"roomName": "104",
"checkin": 1788863400,
"checkout": 1788998400,
"rezervasyon_id": 282799
}
]
}Продукты
У каждого продукта своя документация, справочник API и примеры кода. О выходе новых продуктов мы сообщаем в истории изменений.
Online Booking
API модуля бронирования
Подключает модуль бронирования на сайте отеля к HMS: список номеров и цен, доступность по календарю, купоны, оплата и передача бронирований.
Hotspot
Гостевой Wi-Fi и журналы по закону № 5651
Передаёт в систему хотспота список проживающих гостей: номер, личные данные, время заезда и выезда. Нужен для проверки входа гостей в Wi-Fi по номеру комнаты и ведения журналов доступа по закону Турции № 5651.
Ресторанный 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 APIНовоеНовое
-
Опубликована документация Online Booking APIНовоеНовоеНовое
Возникли сложности?
Наша команда разработчиков отвечает в течение одного рабочего дня.
Приложите тело запроса (скрыв секреты и данные карт), ответ и время. По этому же адресу запрашивайте ключи партнёра, тестовые отели и ранний доступ.