Skip to content
Wink

Webhooki integratsioon

Webhookid võimaldavad teie süsteemidel saada reaalajas teavitusi, kui teie Wink kontol toimuvad sündmused — uued broneeringud, tühistamised, maksete uuendused ja palju muud. See juhend viib teid läbi seadistuse ja parimate tavade.

Sihtgrupp

Section titled “Sihtgrupp”

See juhend on mõeldud arendajatele, kes integreerivad Winki väliste süsteemidega, nagu kinnisvarahaldussüsteemid (PMS), kanalihaldurid, CRM-id või kohandatud juhtpaneelid.

Kuidas webhookid töötavad

Section titled “Kuidas webhookid töötavad”
  1. Registreerite Winkis webhooki URL-i.
  2. Kui toimub sündmus (nt uus broneering), saadab Wink teie URL-ile HTTP POST päringu.
  3. Teie server töötleb andmepaketi ja vastab 200 OK-ga.

Webhooki seadistamine

Section titled “Webhooki seadistamine”
  1. Logige sisse oma kontole (Extranet, Studio või TripPay — kõik toetavad webhooke).
  2. Minge jaotisse Applications ja seejärel Webhooks. Vaadake Webhookid.
  3. Klõpsake Create webhook.
  4. Sisestage nimi (nt “PMS Broneeringu sünkroonimine”).
  5. Sisestage oma webhooki URL — HTTPS lõpp-punkt teie serveris.
  6. Valige sündmused — valige konkreetsed sündmused, millele tellida, või jätke tühjaks, et saada kõik sündmused.
  7. Lülitage Enabled sisse.
  8. Klõpsake Save.

Sündmuste tüübid

Section titled “Sündmuste tüübid”

Wink toetab üle 64 webhooki sündmuse tüübi erinevates kategooriates, sealhulgas konto haldus, broneeringulepingud, maksed, kanalihalduri uuendused ja haldusüksuste haldamine. Levinumad sündmused on:

KategooriaNäited
Broneeringbooking.create, booking.cancelled
Broneeringulepingbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Makseinternal.payment.succeeded, internal.payment.failed
Tagasimaksedbooking.contract.refund.partial, booking.contract.refund.full
Kanalihaldurchannel-manager.update.rate, channel-manager.update.availability
Kontoaccount.create, account.status.updated

Kõigi sündmuste tüüpideta ja kirjeldustega leiate Webhooki sündmuste kataloogist.

Vaata kõiki 64+ sündmuse tüüpi

Parimad tavad

Section titled “Parimad tavad”
  • Kasutage HTTPS-i — Wink saadab andmepakette ainult HTTPS lõpp-punktidele.
  • Vastake kiiresti — Tagastage 200 OK kohe, kui andmepakett on vastu võetud. Kõik mahukad protsessid tehke asünkroonselt.
  • Idempotentsus — Teie töötleja peaks olema idempotentne. Wink võib proovida andmepaketti uuesti saata, kui ei saa 200 vastust.
  • Allika valideerimine — Kontrollige, et sissetulevad päringud pärineksid Winkist enne töötlemist.
  • Logimine — Logige iga vastu võetud webhooki andmepakett. See teeb integreerimisprobleemide silumise palju lihtsamaks.

Peatamine ja kustutamine

Section titled “Peatamine ja kustutamine”

Webhooki saab keelata ilma seda kustutamata. See peatab andmete edastamise, et saaksite tõrkeotsingut teha ilma seadistust kaotamata. Kui olete valmis, lülitage see uuesti sisse.

Webhooki kustutamine eemaldab selle jäädavalt. Kõik integratsioonid, mis sellele webhookile tuginevad, lõpetavad teavituste saamise.

Lisalugemine

Section titled “Lisalugemine”