Skip to content
Wink

Integracija Webhooka

Webhookovi omogućuju vašim sustavima primanje obavijesti u stvarnom vremenu kada se dogode događaji na vašem Wink računu — nove rezervacije, otkazivanja, ažuriranja plaćanja i još mnogo toga. Ovaj vodič vodi vas kroz postavljanje i najbolje prakse.

Publika

Section titled “Publika”

Ovaj vodič je namijenjen developerima koji integriraju Wink s vanjskim sustavima poput sustava za upravljanje nekretninama (PMS), channel managera, CRM-ova ili prilagođenih nadzornih ploča.

Kako webhookovi rade

Section titled “Kako webhookovi rade”
  1. Registrirate URL webhooka na Wink-u.
  2. Kada se dogodi događaj (npr. nova rezervacija), Wink šalje HTTP POST na vaš URL.
  3. Vaš server obrađuje podatke i odgovara s 200 OK.

Postavljanje webhooka

Section titled “Postavljanje webhooka”
  1. Prijavite se na svoj račun (Extranet, Studio ili TripPay — svi podržavaju webhookove).
  2. Idite na Applications, zatim Webhooks. Pogledajte Webhooks.
  3. Kliknite Create webhook.
  4. Unesite ime (npr. “PMS Booking Sync”).
  5. Unesite svoj webhook URL — HTTPS endpoint na vašem serveru.
  6. Odaberite događaje — Odaberite specifične događaje na koje se želite pretplatiti ili ostavite prazno za primanje svih događaja.
  7. Uključite Enabled.
  8. Kliknite Save.

Vrste događaja

Section titled “Vrste događaja”

Wink podržava različite vrste događaja. Uobičajeni događaji uključuju:

  • Booking created — Potvrđena je nova rezervacija.
  • Booking cancelled — Rezervacija je otkazana.
  • Payment completed — Plaćanje je obrađeno.
  • Booking updated — Detalji rezervacije su promijenjeni.

Najbolje prakse

Section titled “Najbolje prakse”
  • Koristite HTTPS — Wink šalje podatke samo na HTTPS endpointove.
  • Odgovarajte brzo — Vratite 200 OK čim primite podatke. Teže obrade radite asinhrono.
  • Idempotentnost — Vaš handler treba biti idempotentan. Wink može pokušati ponovno poslati ako ne primi 200 odgovor.
  • Provjerite izvor — Potvrdite da dolazni zahtjevi dolaze od Wink-a prije obrade.
  • Evidencija — Zabilježite svaki webhook payload koji primite. To olakšava otklanjanje problema s integracijom.

Pauziranje i brisanje

Section titled “Pauziranje i brisanje”

Možete onemogućiti webhook bez brisanja. Time se zaustavlja dostava kako biste mogli riješiti probleme bez gubitka konfiguracije. Kad ste spremni, ponovno ga uključite.

Brisanje webhooka trajno ga uklanja. Svaka integracija koja ovisi o tom webhooku prestat će primati obavijesti.

Dodatno čitanje

Section titled “Dodatno čitanje”