Pāriet uz saturu
Wink

Webhook integrācija

Webhooki ļauj jūsu sistēmām saņemt reāllaika paziņojumus, kad jūsu Wink kontā notiek notikumi — jaunas rezervācijas, atcelšanas, maksājumu atjauninājumi un citi. Šī rokasgrāmata soli pa solim ved cauri iestatīšanai un labākajām praksēm.

Auditorija

Section titled “Auditorija”

Šī rokasgrāmata ir paredzēta izstrādātājiem, kas integrē Wink ar ārējām sistēmām, piemēram, īpašumu pārvaldības sistēmām (PMS), kanālu pārvaldniekiem, CRM vai pielāgotām informācijas paneļiem.

Kā darbojas webhooki

Section titled “Kā darbojas webhooki”
  1. Jūs reģistrējat webhook URL Wink.
  2. Kad notiek notikums (piemēram, jauna rezervācija), Wink nosūta HTTP POST uz jūsu URL.
  3. Jūsu serveris apstrādā datus un atbild ar 200 OK.

Webhook iestatīšana

Section titled “Webhook iestatīšana”
  1. Piesakieties savā kontā (Extranet, Studio vai TripPay — visi atbalsta webhookus).
  2. Dodieties uz Applications un pēc tam Webhooks. Skatīt Webhooks.
  3. Noklikšķiniet uz Create webhook.
  4. Ievadiet nosaukumu (piemēram, “PMS Booking Sync”).
  5. Ievadiet savu webhook URL — HTTPS galapunktu jūsu serverī.
  6. Izvēlieties notikumus — izvēlieties konkrētus notikumus, uz kuriem abonēties, vai atstājiet tukšu, lai saņemtu visus notikumus.
  7. Ieslēdziet Enabled.
  8. Noklikšķiniet uz Save.

Notikumu veidi

Section titled “Notikumu veidi”

Wink atbalsta 64+ webhook notikumu veidus dažādās kategorijās, tostarp konta pārvaldība, rezervāciju līgumi, maksājumi, kanālu pārvaldnieka atjauninājumi un vienību administrēšana. Biežākie notikumi ir:

KategorijaPiemēri
Rezervācijabooking.create, booking.cancelled
Rezervācijas līgumsbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Maksājumsinternal.payment.succeeded, internal.payment.failed
Atmaksasbooking.contract.refund.partial, booking.contract.refund.full
Kanālu pārvaldniekschannel-manager.update.rate, channel-manager.update.availability
Kontsaccount.create, account.status.updated

Pilnu notikumu veidu sarakstu ar aprakstiem skatiet Webhook Events Catalog.

Skatīt visus 64+ notikumu veidus

Labākās prakses

Section titled “Labākās prakses”
  • Izmantojiet HTTPS — Wink nosūta datus tikai uz HTTPS galapunktiem.
  • Atbildiet ātri — Atgrieziet 200 OK tiklīdz saņemat datus. Smagu apstrādi veiciet asinhroni.
  • Idempotentums — Jūsu apstrādātājam jābūt idempotentam. Wink var mēģināt piegādāt datus atkārtoti, ja nesaņem 200 atbildi.
  • Avota pārbaude — Pārbaudiet, ka ienākošie pieprasījumi ir no Wink, pirms tos apstrādājat.
  • Žurnālu veidošana — Reģistrējiet katru saņemto webhook datu kopu. Tas atvieglo integrācijas problēmu novēršanu.

Pauzēšana un dzēšana

Section titled “Pauzēšana un dzēšana”

Jūs varat atspējot webhooku, neizdzēšot to. Tas aptur piegādi, lai varētu veikt problēmu novēršanu, nezaudējot konfigurāciju. Kad esat gatavs, ieslēdziet to atpakaļ.

Webhook dzēšana to neatgriezeniski noņem. Jebkura integrācija, kas paļaujas uz šo webhooku, pārstās saņemt paziņojumus.

Papildu lasāmviela

Section titled “Papildu lasāmviela”