Перейти к основному содержимому

Метод getAuth

📌 Описание​

Метод используется для проверки авторизации и идентификации отеля со стороны OTA.

Он подтверждает, что:

  • переданные учетные данные корректны
  • отель успешно распознан системой OTA
  • интеграция может продолжать работу
Важно

Метод не требует данных в объекте data.

🎯 Назначение метода​

Метод позволяет убедиться, что:

  • переданные учетные данные (auth) корректны
  • отель успешно идентифицирован
  • подключение настроено правильно

Может использоваться:

  • при первичной проверке подключения
  • при отладке интеграции

📤 Пример запроса​

{
  "auth": {},             
  "action": "getAuth",
  "data": {}
}

🔎 Пояснение к параметрам Поле Тип Описание auth object Объект авторизации/идентификации отеля action string Название метода (getAuth) data object Пустой объект данных 📥 Пример успешного ответа OTA

{
  "status": "ok"
}

Авторизация прошла успешно, отель идентифицирован

❌ Пример ошибки авторизации

{
  "status": "error",
  "description": "Ваш отель уже подключен к другой системе управления"
}

Возможные причины:

Отель уже зарегистрирован в другой системе

Передан неверный токен

Ошибка в параметрах auth

🔐 Рекомендации по реализации на стороне OTA​

Валидируйте объект auth для всех запросов

Возвращайте информативные текстовые описания ошибок

Используйте единый формат ответа (status + описание)