Метод 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 + описание)