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, ошибки аутентификации и рекомендации по повторным попыткам.