Skip to content
Wink

Интеграция с Webhook

Webhooks позволяват на вашите системи да получават известия в реално време, когато се случват събития във вашия Wink акаунт — нови резервации, анулации, актуализации на плащания и други. Това ръководство ви превежда през настройката и най-добрите практики.

Аудитория

Section titled “Аудитория”

Това ръководство е за разработчици, които интегрират Wink с външни системи като системи за управление на имоти (PMS), channel managers, CRM системи или персонализирани табла за управление.

Как работят webhooks

Section titled “Как работят webhooks”
  1. Регистрирате URL за webhook в Wink.
  2. Когато настъпи събитие (например нова резервация), Wink изпраща HTTP POST към вашия URL.
  3. Вашият сървър обработва съдържанието и отговаря с 200 OK.

Настройване на webhook

Section titled “Настройване на webhook”
  1. Влезте в акаунта си (Extranet, Studio или TripPay — всички поддържат webhooks).
  2. Отидете на Applications, след това Webhooks. Вижте Webhooks.
  3. Кликнете Create webhook.
  4. Въведете име (например “PMS Booking Sync”).
  5. Въведете вашия webhook URL — HTTPS крайна точка на вашия сървър.
  6. Изберете събития — Изберете конкретни събития за абонамент или оставете празно, за да получавате всички събития.
  7. Включете Enabled.
  8. Кликнете Save.

Видове събития

Section titled “Видове събития”

Wink поддържа над 64 вида webhook събития в категории като управление на акаунти, договори за резервации, плащания, актуализации от channel manager и управление на административни единици. Чести събития включват:

КатегорияПримери
Резервация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 managerchannel-manager.update.rate, channel-manager.update.availability
Акаунтaccount.create, account.status.updated

За пълен списък с всички видове събития и описания вижте Каталог на Webhook събитията.

Вижте всички над 64 вида събития

Най-добри практики

Section titled “Най-добри практики”
  • Използвайте HTTPS — Wink изпраща съдържание само към HTTPS крайни точки.
  • Отговаряйте бързо — Върнете 200 OK веднага след получаване на съдържанието. Тежката обработка правете асинхронно.
  • Идемпотентност — Вашият обработчик трябва да е идемпотентен. Wink може да опита повторно, ако не получи 200 отговор.
  • Проверявайте източника — Уверете се, че входящите заявки са от Wink преди обработка.
  • Логване — Записвайте всяко получено съдържание от webhook. Това улеснява отстраняването на проблеми при интеграцията.

Пауза и изтриване

Section titled “Пауза и изтриване”

Можете да деактивирате webhook без да го изтривате. Това спира доставката, за да можете да отстранявате проблеми без да губите конфигурацията. Когато сте готови, включете го отново.

Изтриването на webhook го премахва завинаги. Всяка интеграция, която разчита на този webhook, ще спре да получава известия.

Допълнително четене

Section titled “Допълнително четене”