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 juhendab teid seadistamise ja parimate tavade osas.

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 Webhooks.
  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 mitmesuguseid sündmuste tüüpe. Levinumad sündmused on:

  • Broneering loodud — uus broneering on kinnitatud.
  • Broneering tühistatud — broneering on tühistatud.
  • Makse lõpetatud — makse on töödeldud.
  • Broneering uuendatud — broneeringu andmed on muutunud.

Parimad tavad

Section titled “Parimad tavad”
  • Kasutage HTTPS-i — Wink saadab andmepakette ainult HTTPS lõpp-punktidele.
  • Vastake kiiresti — tagastage 200 OK kohe, kui saate andmepaketi. Kõik raskemad protsessid tehke asünkroonselt.
  • Idempotentsus — teie töötleja peaks olema idempotentne. Wink võib proovida edastust uuesti, kui ei saa 200 vastust.
  • Allika valideerimine — kontrollige, et sissetulevad päringud pärineksid Winkist, enne kui neid töötlete.
  • Logimine — logige iga vastu võetud webhooki andmepakett. See teeb integreerimisprobleemide silumise palju lihtsamaks.

Peatamine ja kustutamine

Section titled “Peatamine ja kustutamine”

Saate webhooki keelata ilma seda kustutamata. See peatab edastuse, et saaksite tõrkeotsingut teha ilma konfiguratsiooni kaotamata. Kui olete valmis, lülitage see uuesti sisse.

Webhooki kustutamine eemaldab selle jäädavalt. Kõik integreerimised, mis sõltuvad sellest webhookist, lõpetavad teavituste saamise.

Lisalugemine

Section titled “Lisalugemine”