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 г.Нашли ошибку? Напишите нам