Tovább a tartalomhoz
Wink

Webhook integráció

A webhookok lehetővé teszik, hogy rendszereid valós idejű értesítéseket kapjanak, amikor események történnek a Wink fiókodban — új foglalások, lemondások, fizetési frissítések és még sok más. Ez az útmutató végigvezet a beállításon és a legjobb gyakorlatokon.

Célközönség

Szekció neve “Célközönség”

Ez az útmutató fejlesztőknek szól, akik a Wink-et külső rendszerekkel, például ingatlankezelő rendszerekkel (PMS), csatornakezelőkkel, CRM-ekkel vagy egyedi irányítópultokkal integrálják.

Hogyan működnek a webhookok

Szekció neve “Hogyan működnek a webhookok”
  1. Regisztrálsz egy webhook URL-t a Wink-en.
  2. Amikor egy esemény bekövetkezik (pl. új foglalás), a Wink HTTP POST kérést küld az URL-edre.
  3. A szervered feldolgozza a payloadot, és 200 OK választ ad.

Webhook beállítása

Szekció neve “Webhook beállítása”
  1. Jelentkezz be a fiókodba (Extranet, Studio vagy TripPay — mind támogatja a webhookokat).
  2. Navigálj az Applications menüponthoz, majd a Webhooks-hoz. Lásd: Webhooks.
  3. Kattints a Create webhook gombra.
  4. Add meg a nevet (pl. “PMS Foglalás szinkron”).
  5. Add meg a webhook URL-t — a szervered HTTPS végpontját.
  6. Válaszd ki az eseményeket — Válassz ki konkrét eseményeket, vagy hagyd üresen, hogy az összes eseményt megkapd.
  7. Kapcsold be az Enabled opciót.
  8. Kattints a Save gombra.

Eseménytípusok

Szekció neve “Eseménytípusok”

A Wink számos eseménytípust támogat. Gyakori események:

  • Foglalás létrehozva — Egy új foglalás megerősítésre került.
  • Foglalás lemondva — Egy foglalást lemondtak.
  • Fizetés teljesítve — A fizetés feldolgozásra került.
  • Foglalás frissítve — Egy foglalás részletei megváltoztak.

Legjobb gyakorlatok

Szekció neve “Legjobb gyakorlatok”
  • Használj HTTPS-t — A Wink csak HTTPS végpontokra küldi a payloadokat.
  • Válaszolj gyorsan — Küldj 200 OK választ, amint megkaptad a payloadot. A nehéz feldolgozást végezd aszinkron módon.
  • Idempotencia — A kezelőd legyen idempotens. A Wink újrapróbálhatja a kézbesítést, ha nem kap 200 választ.
  • Forrás ellenőrzése — Ellenőrizd, hogy a bejövő kérések valóban a Wink-től származnak, mielőtt feldolgoznád őket.
  • Naplózás — Naplózz minden webhook payloadot, amit kapsz. Ez megkönnyíti az integrációs hibák hibakeresését.

Szüneteltetés és törlés

Szekció neve “Szüneteltetés és törlés”

Egy webhookot letilthatsz anélkül, hogy törölnéd. Ez szünetelteti a kézbesítést, így hibakeresés közben megőrizheted a beállításokat. Ha készen állsz, kapcsold vissza.

A webhook törlése véglegesen eltávolítja azt. Az az integráció, amely erre a webhookra támaszkodik, nem fog több értesítést kapni.

További olvasnivaló

Szekció neve “További olvasnivaló”