Поддержка
Обращайтесь к нашей команде разработчиков по любому вопросу, который мешает интеграции. Рекомендуем сначала заглянуть на страницу Коды ошибок нужного продукта: там есть ответы на большинство вопросов.
Технические вопросы, сообщения об ошибках, запросы ключа партнёра и тестового отеля. Отвечаем в течение одного рабочего дня.
Ключ партнёра
Для доступа нужен аккаунт партнёра, выданный HMS. Отправьте нам по e-mail данные вашей компании и список отелей, которые вы будете интегрировать; для тестовой среды вы получите apiKey, apiSecret и ID отеля.
Сообщая о проблеме, приложите
- Продукт и эндпоинт (например, Online Booking ·
POST /external/online/roomType) - Полное тело запроса и ответ, скрыв
apiSecret, токен и данные карт - Время отправки запроса (с часовым поясом) и
hotelID - Ожидаемый результат и воспроизводится ли проблема
Частые вопросы
Что нужно, чтобы пользоваться API?
Аккаунт партнёра, выданный HMS (apiKey / apiSecret), и доступ к отелю, который вы интегрируете. На стороне отеля должен быть включён соответствующий модуль (например, канал онлайн-бронирования).
Есть ли тестовая среда?
Да. Примеры в этой документации используют тестовую среду (test.hms.gen.tr); для разработки вы получите запись отеля и ключ партнёра в ней. Адрес рабочей среды и рабочие ключи выдаются после одобрения интеграции.
Я получаю 401.
Токен отсутствует, истёк, передан без префикса Bearer или принадлежит другому отелю. Выполните вход заново и повторите запрос. Если вход возвращает success: false, проверьте message: неверная пара ключей или нет доступа к отелю.
Список номеров пуст или roomCount равен 0.
Онлайн-канал отеля закрыт (errorCode 10003), нет типов номеров, открытых для продажи (10004), или действуют ограничения по датам и количеству гостей. Для номеров с roomCount 0 причину указывает roomRestrictionMessage (минимальный срок проживания, закрыто для заезда, цена не задана).
Я передал бронирование, но оно не отображается в панели.
Проверьте, есть ли Error в BookingPushRS. Hotel registration not found on HMS. означает, что отель не подключён к онлайн-каналу; Could not register. обычно означает неверный roomTypeID / ratePlanID или несогласованные даты.
Когда появится API других модулей?
Документация Ресторанного POS, Spa, ИИ, TV и АТС добавляется поэтапно. Даты выхода объявляются в истории изменений; если нужен ранний доступ к конкретному модулю, напишите нам.