Skip to content
Wink

Webhook integracija

Webhook’ai leidžia jūsų sistemoms gauti realaus laiko pranešimus, kai jūsų Wink paskyroje įvyksta įvykiai — nauji užsakymai, atšaukimai, mokėjimų atnaujinimai ir daugiau. Šis vadovas padės jums juos nustatyti ir pateiks geriausias praktikas.

Auditorija

Section titled “Auditorija”

Šis vadovas skirtas kūrėjams, integruojantiems Wink su išorinėmis sistemomis, tokiomis kaip nekilnojamojo turto valdymo sistemos (PMS), kanalų valdytojai, CRM ar individualios valdymo skydeliai.

Kaip veikia webhook’ai

Section titled “Kaip veikia webhook’ai”
  1. Užregistruojate webhook URL Wink sistemoje.
  2. Kai įvyksta įvykis (pvz., naujas užsakymas), Wink siunčia HTTP POST užklausą į jūsų URL.
  3. Jūsų serveris apdoroja duomenis ir atsako su 200 OK.

Webhook’o nustatymas

Section titled “Webhook’o nustatymas”
  1. Prisijunkite prie savo paskyros (Extranet, Studio arba TripPay — visi palaiko webhook’us).
  2. Eikite į Applications, tada Webhooks. Žr. Webhook’ai.
  3. Spustelėkite Create webhook.
  4. Įveskite pavadinimą (pvz., „PMS užsakymų sinchronizavimas“).
  5. Įveskite savo webhook URL — HTTPS galinį tašką jūsų serveryje.
  6. Pasirinkite įvykius — Pasirinkite konkrečius įvykius, kuriuos norite prenumeruoti, arba palikite tuščią, kad gautumėte visus įvykius.
  7. Įjunkite Enabled.
  8. Spustelėkite Save.

Įvykių tipai

Section titled “Įvykių tipai”

Wink palaiko daugiau nei 64 webhook įvykių tipus įvairiose kategorijose, įskaitant paskyros valdymą, užsakymų sutartis, mokėjimus, kanalų valdytojų atnaujinimus ir valdymo subjektų administravimą. Dažniausi įvykiai:

KategorijaPavyzdžiai
Užsakymasbooking.create, booking.cancelled
Užsakymo sutartisbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Mokėjimasinternal.payment.succeeded, internal.payment.failed
Grąžinimaibooking.contract.refund.partial, booking.contract.refund.full
Kanalų valdytojaschannel-manager.update.rate, channel-manager.update.availability
Paskyraaccount.create, account.status.updated

Visą įvykių tipų sąrašą su aprašymais rasite Webhook įvykių kataloge.

Peržiūrėti visus daugiau nei 64 įvykių tipus

Geriausios praktikos

Section titled “Geriausios praktikos”
  • Naudokite HTTPS — Wink siunčia duomenis tik į HTTPS galinius taškus.
  • Atsakykite greitai — Grąžinkite 200 OK iš karto gavę duomenis. Sunkų apdorojimą atlikite asinchroniškai.
  • Idempotentiškumas — Jūsų apdorojimo funkcija turėtų būti idempotentiška. Wink gali bandyti pakartotinai pristatyti, jei negauna 200 atsakymo.
  • Patikrinkite šaltinį — Patikrinkite, ar gaunami užklausimai tikrai iš Wink prieš juos apdorojant.
  • Registravimas — Fiksuokite kiekvieną gautą webhook duomenų paketą. Tai labai palengvina integracijos klaidų paiešką.

Sustabdymas ir ištrynimas

Section titled “Sustabdymas ir ištrynimas”

Galite išjungti webhook’ą, jo neištrindami. Tai sustabdo pranešimų siuntimą, kad galėtumėte spręsti problemas neprarandant nustatymų. Kai būsite pasiruošę, vėl įjunkite.

Ištrynus webhook’ą, jis pašalinamas visam laikui. Bet kokia integracija, priklausanti nuo to webhook’o, nustos gauti pranešimus.

Tolimesnė informacija

Section titled “Tolimesnė informacija”