Online Booking API

ДоступноHMS API V2API модуля бронювання

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

Базова URL-адреса
https://test.hms.gen.tr
Автентифікація
apiKey / apiSecret → Bearer-токен
Формат
Відповіді JSON · тіла запитів у форматі форми або JSON
Обсяг
8 ресурсів · 16 ендпоінтів

Ресурси#

Автентифікація

1 ендпоінт

Доступ до Online Booking API надається за партнерськими обліковими даними, які видає HMS. Ендпоінт входу обмінює apiKey і apiSecret на токен, який над…

  • POST/external/public/login

Номери й ціни

2 ендпоінти

Два ендпоінти, на яких побудовано результати пошуку в модулі бронювання: список номерів повертає доступні для продажу типи номерів, типи харчування й …

  • POST/external/online/roomType
  • GET/external/room/type/hotel/availability

Бронювання

1 ендпоінт

Номер, тип харчування й тариф, які обрав гість, передаються в HMS у структурі BookingPushRQ. Той самий ендпоінт обробляє скасування та зміни, якщо в п…

  • POST/external/online/channel/booking

Оплата

3 ендпоінти

Повертає типи оплати, які готель приймає для онлайн-бронювань, і запускає крок оплати для вибраного типу. Що робити для кожного типу, описано в посібн…

  • GET/external/online/payment/type
  • GET/external/payment/company
  • POST/external/online/payment/type/{paymentType}

Купон

1 ендпоінт

Перевіряє онлайн-купони на знижку, які готель створив у панелі. Застосуйте знижку на своєму боці й передайте в бронюванні суми зі знижкою.

  • POST/external/online/coupon/search

Пакети й додаткові послуги

1 ендпоінт

Додаткові послуги, які можна продати разом із бронюванням: пакети номерів (прив’язані до типу номера) і загальні пакети (трансфер, вечеря, спа). Прода…

  • GET/external/stock/packages

Інформація про готель

4 ендпоінти

Дані для оформлення сторінок модуля бронювання: контакти й розташування, посилання на соціальні мережі, тексти футера (юридична інформація, про готель…

  • GET/external/hotel/{hotelID}/contact/info
  • GET/external/online/social/media
  • GET/external/online/footer
  • ще 1

Довідники

3 ендпоінти

Статичні списки для варіантів у формах: країни, валюти й мови. Вони змінюються рідко, тож їх можна кешувати на добу.

  • POST/external/counties
  • GET/external/currencies
  • GET/external/languages

Документація#

Початок роботи

Посібники

Останнє оновлення: 21 вересня 2026 р.Знайшли помилку? Повідомте нам