Skip to content
Wink

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

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

Аудитория

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

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

Как работят webhooks

Section titled “Как работят webhooks”
  1. Регистрирате webhook URL в 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 поддържа различни видове събития. Често срещаните събития включват:

  • Създадена резервация — Потвърдена е нова резервация.
  • Отменена резервация — Резервация е отменена.
  • Плащането е завършено — Плащането е обработено.
  • Актуализирана резервация — Детайли по резервация са променени.

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

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

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

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

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

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

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

Section titled “Допълнително четене”
  • Webhooks — Пълна справка за управление на webhook.
  • Applications — Управление на вашите API идентификационни данни.
  • Developers > APIs — Пълна API документация.