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

Интеграция Webhook

Вебхуки позволяют вашим системам получать уведомления в реальном времени при событиях в вашем аккаунте Wink — новые бронирования, отмены, обновления платежей и многое другое. Это руководство проведет вас через процесс настройки и лучшие практики.

Аудитория

Заголовок раздела «Аудитория»

Это руководство предназначено для разработчиков, интегрирующих Wink с внешними системами, такими как системы управления недвижимостью (PMS), менеджеры каналов, CRM или пользовательские панели управления.

Как работают вебхуки

Заголовок раздела «Как работают вебхуки»
  1. Вы регистрируете URL вебхука в Wink.
  2. Когда происходит событие (например, новое бронирование), Wink отправляет HTTP POST на ваш URL.
  3. Ваш сервер обрабатывает полезную нагрузку и отвечает 200 OK.

Настройка вебхука

Заголовок раздела «Настройка вебхука»
  1. Войдите в свой аккаунт (Extranet, Studio или TripPay — все поддерживают вебхуки).
  2. Перейдите в раздел Applications, затем Webhooks. См. Webhooks.
  3. Нажмите Create webhook.
  4. Введите название (например, “PMS Booking Sync”).
  5. Введите URL вебхука — HTTPS-эндпоинт на вашем сервере.
  6. Выберите события — выберите конкретные события для подписки или оставьте пустым, чтобы получать все события.
  7. Включите переключатель Enabled.
  8. Нажмите Save.

Типы событий

Заголовок раздела «Типы событий»

Wink поддерживает более 64 типов событий вебхуков в категориях, включая управление аккаунтом, контракты бронирования, платежи, обновления менеджера каналов и управление сущностями. Распространённые события включают:

КатегорияПримеры
Бронированиеbooking.create, booking.cancelled
Контракт бронированияbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Платежinternal.payment.succeeded, internal.payment.failed
Возвратыbooking.contract.refund.partial, booking.contract.refund.full
Менеджер каналовchannel-manager.update.rate, channel-manager.update.availability
Аккаунтaccount.create, account.status.updated

Для полного списка всех типов событий с описаниями смотрите Каталог событий вебхуков.

Просмотреть все 64+ типов событий

Лучшие практики

Заголовок раздела «Лучшие практики»
  • Используйте HTTPS — Wink отправляет полезные нагрузки только на HTTPS-эндпоинты.
  • Отвечайте быстро — Возвращайте 200 OK сразу после получения полезной нагрузки. Тяжёлую обработку выполняйте асинхронно.
  • Идемпотентность — Ваш обработчик должен быть идемпотентным. Wink может повторять доставку, если не получает ответ 200.
  • Проверяйте источник — Убедитесь, что входящие запросы действительно от Wink, прежде чем обрабатывать их.
  • Логирование — Логируйте каждую полученную полезную нагрузку вебхука. Это значительно облегчает отладку интеграции.

Приостановка и удаление

Заголовок раздела «Приостановка и удаление»

Вы можете отключить вебхук без удаления. Это приостанавливает доставку, чтобы вы могли устранить неполадки, не теряя настройки. Когда будете готовы, включите его снова.

Удаление вебхука навсегда удаляет его. Любая интеграция, зависящая от этого вебхука, перестанет получать уведомления.

Дополнительные материалы

Заголовок раздела «Дополнительные материалы»