Skip to content
Wink

Integracija Webhook-a

Webhook-ovi omogućavaju vašim sistemima da primaju obaveštenja u realnom vremenu kada se dogode događaji na vašem Wink nalogu — nove rezervacije, otkazivanja, ažuriranja plaćanja i još mnogo toga. Ovaj vodič vas vodi kroz postavljanje i najbolje prakse.

Publika

Section titled “Publika”

Ovaj vodič je namenjen programerima koji integrišu Wink sa eksternim sistemima kao što su sistemi za upravljanje nekretninama (PMS), menadžeri kanala, CRM-ovi ili prilagođene kontrolne table.

Kako webhook-ovi funkcionišu

Section titled “Kako webhook-ovi funkcionišu”
  1. Registrujete URL webhook-a 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 sa 200 OK.

Postavljanje webhook-a

Section titled “Postavljanje webhook-a”
  1. Prijavite se na svoj nalog (Extranet, Studio ili TripPay — svi podržavaju webhook-ove).
  2. Idite na Applications, zatim Webhooks. Pogledajte Webhooks.
  3. Kliknite na Create webhook.
  4. Unesite ime (npr. “PMS Sinhronizacija rezervacija”).
  5. Unesite svoj webhook URL — HTTPS krajnju tačku na vašem serveru.
  6. Izaberite događaje — Odaberite specifične događaje na koje želite da se pretplatite, ili ostavite prazno da primate sve događaje.
  7. Uključite Enabled.
  8. Kliknite na Save.

Tipovi događaja

Section titled “Tipovi događaja”

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

  • Rezervacija kreirana — Nova rezervacija je potvrđena.
  • Rezervacija otkazana — Rezervacija je otkazana.
  • Plaćanje završeno — Plaćanje je obrađeno.
  • Rezervacija ažurirana — Detalji rezervacije su promenjeni.

Najbolje prakse

Section titled “Najbolje prakse”
  • Koristite HTTPS — Wink šalje podatke samo na HTTPS krajnje tačke.
  • Odgovarajte brzo — Vratite 200 OK čim primite podatke. Sve zahtevnije obrade radite asinhrono.
  • Idempotentnost — Vaš handler treba da bude idempotentan. Wink može ponovo pokušati isporuku ako ne dobije 200 odgovor.
  • Validirajte izvor — Proverite da li su dolazni zahtevi sa Wink-a pre nego što ih obradite.
  • Logovanje — Beležite svaki webhook payload koji primite. Ovo znatno olakšava rešavanje problema sa integracijom.

Pauziranje i brisanje

Section titled “Pauziranje i brisanje”

Možete onemogućiti webhook bez brisanja. Ovo pauzira isporuku kako biste mogli da rešavate probleme bez gubitka konfiguracije. Kada budete spremni, ponovo ga uključite.

Brisanje webhook-a trajno ga uklanja. Svaka integracija koja zavisi od tog webhook-a prestaje da prima obaveštenja.

Dalje čitanje

Section titled “Dalje čitanje”