Что синхронизировать с Avtomatizaciya-Otelya

Для создания полноценной экосистемы управления отелем рекомендуется синхронизировать следующие сущности API:

• Бронирования (Reservations): передача статусов и деталей проживания в CRM/Channel Manager. Метод: GET /v1/reservations/{id}.
• Тарифная сетка (Rates): автоматическое обновление цен в зависимости от загрузки. Метод: PUT /v1/rates/update.
• Квоты номеров (Inventory): управление доступностью для OTA-каналов. Метод: POST /v1/inventory/sync.
• Профили гостей (Guest Profiles): синхронизация данных для программ лояльности и email-маркетинга. Метод: GET /v1/guests/{id}.
• Счета и транзакции (Invoices): выгрузка финансовых данных в учетные системы (1С, SAP). Метод: GET /v1/invoices/export.
• Статус уборки (Housekeeping): передача данных для мобильных приложений горничных. Метод: PATCH /v1/rooms/{id}/status.
• Категории номеров (Room Types): синхронизация описаний и базовых параметров. Метод: GET /v1/room-types.

Технические особенности API Avtomatizaciya-Otelya

• Аутентификация: использование Bearer-токенов. Заголовок запроса должен содержать Authorization: Bearer {your_api_key}.
• Формат данных: обмен осуществляется исключительно в формате JSON. Заголовки Content-Type: application/json обязательны.
• Rate Limits: лимит составляет 100 запросов в минуту для одного API-ключа. Превышение возвращает HTTP 429 Too Many Requests.
• Версионирование: актуальная версия API находится по пути /v1/. Изменения в логике сопровождаются выпуском версии /v2/.
• Вебхуки: система поддерживает передачу событий (бронирование создано, отменено) через POST-запросы на указанный Webhook URL.
• Обработка ошибок: 401 Unauthorized (неверный ключ), 403 Forbidden (недостаточно прав), 422 Unprocessable Entity (ошибка валидации полей).
• Тестовая среда: доступна Sandbox-среда с отдельным набором ключей, полностью имитирующая работу Production-API.

Часто задаваемые вопросы о Avtomatizaciya-Otelya

Как получить API-ключ?
Ключ генерируется в личном кабинете администратора в разделе «Настройки интеграций» -> «API Credentials». Убедитесь, что у вашего аккаунта есть права доступа уровня «Admin».

Есть ли лимиты на количество запросов?
Да, стандартный лимит составляет 100 RPS. При необходимости высоконагруженной интеграции необходимо связаться с техподдержкой для расширения квот.

Поддерживаются ли вебхуки в реальном времени?
Да, вы можете настроить подписку на события (создание, изменение, удаление брони) через метод POST /v1/webhooks. Система отправит уведомление в течение 1-2 секунд после события.

Можно ли протестировать API без риска для реальных данных?
Да, используйте Sandbox-версию API по адресу api-sandbox.avtomatizaciya-otelya.ru. Все операции в этом контуре являются тестовыми и не влияют на реальный номерной фонд.

Совместимы ли версии API между собой?
Версии API независимы. Мы гарантируем поддержку старых версий (v1) в течение 12 месяцев после выхода обновлений (v2).

Где найти полную документацию?
Актуальная техническая документация со схемой объектов и примерами запросов доступна по адресу docs.avtomatizaciya-otelya.ru. Настроить интеграцию Avtomatizaciya-Otelya под ключ — flowframe.ru, от 40 000 ₽, срок 7-21 день.