Online Booking API
Підключає модуль бронювання на сайті готелю до 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
Документація#
Початок роботи
- ОглядЩо робить Online Booking API, базова URL-адреса, короткий опис процесу та загальні правила.
- Швидкий стартОтримайте токен за партнерськими обліковими даними й надішліть перший запит номерів і цін.
- АвтентифікаціяВхід з apiKey / apiSecret, Bearer-токен, контекст готелю та строк дії токена.
- Запити й відповідіТіла у форматі форми та JSON, обгортка success, пагінація, формати дат і сум, коди стану HTTP.
- Коди помилокЗначення message і errorCode, помилки автентифікації та рекомендації щодо повторних спроб.