Интеграция 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, прежде чем обрабатывать их.
• Логирование — Логируйте каждую полученную полезную нагрузку вебхука. Это значительно облегчает отладку интеграции.

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

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

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

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

• Каталог событий вебхуков — Полный список всех 64+ типов событий.
• Webhooks — Полное руководство по управлению вебхуками.
• Applications — Управление вашими API-учетными данными.
• Developers > APIs — Полная документация по API.