Підключайте своє ПЗ до модулів HMS
Окрема документація API для кожного модуля готельної програми: модуля бронювання, гостьового Wi-Fi, ресторанного POS, спа, TV, АТС і сервісів ШІ. Online Booking API і Hotspot API вже доступні, інші з’являться згодом.
- Автентифікація
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
Передає до системи hotspot список гостей, які проживають у готелі: номер, особисті дані, час заїзду й виїзду. Для перевірки входу гостей у Wi-Fi за номером кімнати та ведення журналів доступу згідно з турецьким законом № 5651.
Ресторанний POS
Чеки та нарахування на номер
Перенесення чеків ресторану, бару й кафе на фоліо номера, синхронізація меню та складських залишків.
Spa
Записи та послуги
Записи на спа- та велнес-процедури, каталог послуг та інтеграція з нарахуванням на номер.
ШІ
Сервіси асистента й рекомендацій
Доступ до сервісів ШІ для асистента гостей, рекомендацій щодо тарифів і звітності.
TV
Телевізійні системи в номерах
Дані гостя, фоліо, повідомлення та запити на послуги для 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НовеНовеНове
Щось не виходить?
Наша команда розробників відповідає протягом одного робочого дня.
Додайте тіло запиту (з прихованими секретами й даними карток), відповідь і час. Ця сама адреса — для запитів на партнерські ключі, тестові готелі й ранній доступ.