Интеграция Webhook

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

Аудитория

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

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

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

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

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

Типы событий

Wink поддерживает различные типы событий. Распространённые события включают:

Booking created — Подтверждено новое бронирование.
Booking cancelled — Бронирование отменено.
Payment completed — Платеж обработан.
Booking updated — Изменились детали бронирования.

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

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

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

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

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

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

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