База знаний

Какие данные синхронизируются

На схеме показаны этапы получения описания средства размещения в Content API — описание средства размещения, категорий номеров, тарифов, услуг, фото средства размещения и категорий номеров:

Синхронизация работает только по объектам, которые настроят интеграцию с каналом продаж в менеджере каналов.

Мы не проверяем данные, которые отельеры добавляют в экстранете Exely. Канал продаж при получении данных в Content API может проверить данные самостоятельно. Как правило, средства размещения хорошо следят за контентом, так как эта информация отображается на официальном сайте средства размещения при помощи модуля бронирования Exely Booking Engine.

Как получить полное описание всех объектов размещения

В методе /v1/properties Content API впишите в поле «include» — all.

В каком порядке отображаются изображения в api/content и api/search

Порядок устанавливается отельером в экстранете Exely и каналу продаж необходимо реализовать порядок отображения изображений объекта размещения или категории номера, который приходит по API.

Можно ли в Exely внести данные для конкретного канала?

Такие данные средство размещения заполняет на стороне канала. Мы можем разместить только общую информацию и ссылку на ваш канал, при переходе по которой отель сможет заполнить все необходимые данные на вашей стороне. Пример того, что будет видеть отель:

Пример ссылки на форму регистрации: https://secure.101hotels.com/join

Информация о кроватях в номере

В теле ответа методов описания объектов размещений появились «Оснащения номеров» — roomTypes.amenities. Реализован справочник «Оснащения номеров» — /v1/room-amenity-categories.

Отправка событий каналам продаж через API

Каналы продаж могут получать события, чтобы оперативно реагировать на изменение данных в Exely. Событийная модель реализована на основе webhooks — механизма оповещения пользователей системы о событиях. На схеме показаны этапы получения событий при изменении данных в Content API:

Виды событий:

• Добавление прав на средство размещения в рамках партнера (канала продаж).

• Удаление прав на средство размещения в рамках партнера (канала продаж).

• Изменение подключенного средства размещения к партнеру (каналу продаж). При обновлении прав партнера на средство размещения отправляются webhooks на изменение средства размещения. Отдельного события на изменение прав партнера на средство размещения не планируется.

Способ получения событий:

Канал продаж реализует на своей стороне публичный API endpoint, принимающий события, к которому система Exely может обращаться с авторизованным доступом.

При изменении контентной информации отельером на стороне Exely: описание и фото средства размещения, категорий номеров и тарифов — система Exely направляет webhooks о том, что данные изменились, с помощью обращения к публичному endpoint.

Особенности:

• При получении ответа со статусом, отличным от 200, система Exely производит попытку повторного запроса. Задержка перед отправкой повторного запроса составляет 1 секунду.

• Таймаут при отправке событий — 45 секунд.

• События хранятся 3 дня.

Пример запроса:

Параметры:

• entityId — идентификатор сущности, по которой произошло изменение (средства размещения);

• eventType — тип события;

• eventCreationTime — время, когда событие произошло.

Периодичность отправки событий: события направляются пачками каждые 2 минуты, если за этот промежуток времени появились события для отправки. События в рамках одной пачки могут повторяться, в случае если произошло несколько изменений.

На первом этапе для подписки на события, необходимо направить следующие данные:

• Типы событий, которые ожидаете получать.

• API endpoint URL.

• API KEY для обеспечения авторизованного доступа.

Обратите внимание. При получении webhooks важно сохранить текущий принцип актуализации контента — обращение к методам Content API — 1 раз в сутки в ночное время, так как система Exely не гарантирует доставку всех сообщений до партнеров.