Skip to content
Wink

Integracija Webhookov

Webhooki omogočajo vašim sistemom prejemanje obvestil v realnem času, ko se na vašem Wink računu zgodijo dogodki — nove rezervacije, odpovedi, posodobitve plačil in še več. Ta vodič vas vodi skozi nastavitev in najboljše prakse.

Ciljna publika

Section titled “Ciljna publika”

Ta vodič je namenjen razvijalcem, ki integrirajo Wink z zunanjimi sistemi, kot so sistemi za upravljanje nepremičnin (PMS), upravljalci kanalov, CRM-ji ali prilagojene nadzorne plošče.

Kako webhooki delujejo

Section titled “Kako webhooki delujejo”
  1. Registrirate URL webhooka na Wink.
  2. Ko se zgodi dogodek (npr. nova rezervacija), Wink pošlje HTTP POST na vaš URL.
  3. Vaš strežnik obdela podatke in odgovori z 200 OK.

Nastavitev webhooka

Section titled “Nastavitev webhooka”
  1. Prijavite se v svoj račun (Extranet, Studio ali TripPay — vsi podpirajo webhooke).
  2. Pojdite na Applications in nato Webhooks. Oglejte si Webhooke.
  3. Kliknite Create webhook.
  4. Vnesite ime (npr. “PMS Sinhronizacija rezervacij”).
  5. Vnesite svoj webhook URL — HTTPS končno točko na vašem strežniku.
  6. Izberite dogodke — Izberite specifične dogodke, na katere se želite naročiti, ali pustite prazno, da prejmete vse dogodke.
  7. Vklopite Enabled.
  8. Kliknite Save.

Vrste dogodkov

Section titled “Vrste dogodkov”

Wink podpira več kot 64 vrst webhook dogodkov v kategorijah, kot so upravljanje računa, pogodbe o rezervacijah, plačila, posodobitve upravljalca kanalov in upravljanje entitet. Pogosti dogodki vključujejo:

KategorijaPrimeri
Rezervacijabooking.create, booking.cancelled
Pogodba o rezervacijibooking.contract.created, booking.contract.processing, booking.contract.cancelled
Plačilointernal.payment.succeeded, internal.payment.failed
Povračilabooking.contract.refund.partial, booking.contract.refund.full
Upravljalec kanalovchannel-manager.update.rate, channel-manager.update.availability
Računaccount.create, account.status.updated

Za popoln seznam vseh vrst dogodkov z opisi si oglejte Katalog webhook dogodkov.

Ogled vseh več kot 64 vrst dogodkov

Najboljše prakse

Section titled “Najboljše prakse”
  • Uporabljajte HTTPS — Wink pošilja podatke samo na HTTPS končne točke.
  • Odgovarjajte hitro — Vrnete 200 OK takoj, ko prejmete podatke. Vse zahtevnejše obdelave izvajajte asinhrono.
  • Idempotentnost — Vaš obdelovalec naj bo idempotenten. Wink lahko poskuša ponovno dostavo, če ne prejme odgovora 200.
  • Preverite vir — Pred obdelavo preverite, da so dohodni zahtevki iz Wink.
  • Zapisovanje — Beležite vsak prejeti webhook payload. To močno olajša odpravljanje težav pri integraciji.

Zaustavitev in brisanje

Section titled “Zaustavitev in brisanje”

Webhook lahko onemogočite brez brisanja. To začasno ustavi dostavo, da lahko odpravljate težave brez izgube nastavitve. Ko ste pripravljeni, ga ponovno vklopite.

Brisanje webhooka ga trajno odstrani. Vsaka integracija, ki je odvisna od tega webhooka, bo prenehala prejemati obvestila.

Dodatno branje

Section titled “Dodatno branje”