Skip to content
Wink

Vefkroka samþætting

Vefkrokar leyfa kerfum þínum að fá rauntímatilkynningar þegar atvik eiga sér stað á Wink reikningnum þínum — nýjar bókanir, afbókanir, uppfærslur á greiðslum og fleira. Þessi leiðarvísir leiðir þig í gegnum uppsetningu og bestu vinnubrögð.

Áhorfendur

Section titled “Áhorfendur”

Þessi leiðarvísir er fyrir forritara sem samþætta Wink við ytri kerfi eins og eignastýringarkerfi (PMS), rásastjóra, CRM-kerfi eða sérsniðin mælaborð.

Hvernig vefkrokar virka

Section titled “Hvernig vefkrokar virka”
  1. Þú skráir vefkroka-URL á Wink.
  2. Þegar atvik á sér stað (t.d. ný bókun) sendir Wink HTTP POST á þitt URL.
  3. Þinn netþjónn vinnur úr gögnum og svarar með 200 OK.

Uppsetning vefkroka

Section titled “Uppsetning vefkroka”
  1. Skráðu þig inn á reikninginn þinn (Extranet, Studio eða TripPay — allir styðja vefkroka).
  2. Farðu í Applications og síðan Webhooks. Sjá Webhooks.
  3. Smelltu á Create webhook.
  4. Sláðu inn nafn (t.d. “PMS Booking Sync”).
  5. Sláðu inn þitt vefkroka-URL — HTTPS endapunkt á netþjóninum þínum.
  6. Veldu atvik — Veldu tiltekna atburði til að gerast áskrifandi að, eða skildu tómt til að fá öll atvik.
  7. Kveiktu á Enabled.
  8. Smelltu á Save.

Tegundir atvika

Section titled “Tegundir atvika”

Wink styður 64+ tegundir vefkroka atvika í flokkum eins og reikningsstjórnun, bókunarsamningum, greiðslum, uppfærslum rásastjóra og stjórnun aðila. Algeng atvik eru:

FlokkurDæmi
Bókunbooking.create, booking.cancelled
Bókunarsamningurbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Greiðslainternal.payment.succeeded, internal.payment.failed
Endurgreiðslurbooking.contract.refund.partial, booking.contract.refund.full
Rásastjórichannel-manager.update.rate, channel-manager.update.availability
Reikninguraccount.create, account.status.updated

Fyrir fullkominn lista yfir allar tegundir atvika með lýsingum, sjá Webhook Events Catalog.

Skoða allar 64+ tegundir atvika

Bestu vinnubrögð

Section titled “Bestu vinnubrögð”
  • Notaðu HTTPS — Wink sendir gögn aðeins á HTTPS endapunkta.
  • Svaraðu fljótt — Skilaðu 200 OK um leið og þú færð gögnin. Gerðu þung vinnsla í bakgrunni.
  • Idempotency — Meðhöndlarinn þinn ætti að vera idempotent. Wink gæti reynt að senda aftur ef það fær ekki 200 svar.
  • Staðfestu uppruna — Staðfestu að beiðnir séu frá Wink áður en þú vinnur úr þeim.
  • Skráning — Skráðu öll gögn sem þú færð í vefkroka. Þetta auðveldar bilanaleit á samþættingu.

Stöðvun og eyðing

Section titled “Stöðvun og eyðing”

Þú getur slökkt á vefkroka án þess að eyða honum. Þetta stöðvar sendingar svo þú getir leyst úr vandamálum án þess að tapa stillingum. Þegar þú ert tilbúinn, kveiktu aftur á honum.

Eyðing vefkroka fjarlægir hann varanlega. Öll samþætting sem byggir á þeim mun hætta að fá tilkynningar.

Frekari lesning

Section titled “Frekari lesning”