Портал для розробниківГотельна програма HMS

Підключайте своє ПЗ до модулів 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"
Відповідь · 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

Передає до системи hotspot список гостей, які проживають у готелі: номер, особисті дані, час заїзду й виїзду. Для перевірки входу гостей у Wi-Fi за номером кімнати та ведення журналів доступу згідно з турецьким законом № 5651.

1 ресурс · 1 ендпоінтДокументація
Незабаром

Ресторанний 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
    Опубліковано документацію Hotspot API
    НовеНове
  • Online Booking
    Опубліковано документацію Online Booking API
    НовеНовеНове

Щось не виходить?

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

Додайте тіло запиту (з прихованими секретами й даними карток), відповідь і час. Ця сама адреса — для запитів на партнерські ключі, тестові готелі й ранній доступ.