Valós idejű webhookok, amelyek egyetlen eseményt sem hagynak ki
Streamelje minden foglalási és fizetési eseményt saját rendszereibe — CRM, adatraktár, Slack, egyéni integrációk. HMAC-aláírással ellátva, exponenciális visszalépéssel újrapróbálva és teljes naplóval dokumentálva. Olyan fejlesztői csapatoknak készült, akik nem akarnak API-t lekérdezgetni.
Miért választják a fejlesztői csapatok a Triviyo webhookokat
Szabványos minták, kiszámítható viselkedés és egy kézbesítési napló, amely tényleg segít a hibakeresésben.
Egy másodpercen belül tüzel
Az eseményeket az aktiváló művelettől számított 500 ms-en belül kézbesítjük — nincs lekérdezés, nincs késés, nincs kihagyott foglalás. A downstream rendszereid tökéletes szinkronban maradnak a Triviyo-val.
HMAC-aláírás minden payloadon
Minden webhookot HMAC-SHA256 algoritmussal írunk alá az adott végpont titkos kulcsával. Ellenőrizd az aláírást, mielőtt feldolgozod a payloadot — ugyanaz a minta, mint a Stripe, GitHub és minden más általad már megbízott webhook.
Újrapróbálkozás exponenciális visszalépéssel
Ha a végpontod nem 2xx-et ad vissza, a Triviyo exponenciális visszalépéssel újrapróbálkozik, akár 72 órán át. Az átmeneti hibák maguktól rendeződnek, manuális beavatkozás nélkül — és bármely eseményt visszajátszhatod a kézbesítési naplóból.
Szabványos eseménynevek
booking.created, booking.updated, booking.cancelled, payment.succeeded — az összes fejlesztő által ismert és elvárt nevek. Iratkozz fel pontosan azokra az eseményekre, amelyekre az integrációdnak szüksége van; a többit hagyhatod figyelmen kívül.
Végpontonkénti titkok és engedélylisták
Minden végpont saját aláíró titkot és opcionális IP-engedélylistát kap a fogadó oldalon. Forgasd le a titkokat állásidő nélkül, és korlátozd a végpontokat kizárólag a saját infrastruktúrádra.
Teljes kézbesítési napló visszajátszással
Minden kézbesítési kísérlet naplózva van státuszkóddal, válasz törzsével és időbélyeggel — elérhető a dashboardon és az API-n keresztül. Játssz vissza bármely eseményt manuálisan, ha a staging környezeted lekésett egyet.
Triviyo webhookok vs. REST API lekérdezgetése
Így néz ki a valós idejű eseménystreamelés a REST végpont folyamatos letapogatásával szemben.
| Mit tartalmaz a webhooks API | Triviyo | Without Triviyo |
|---|---|---|
| Beállítási idő | 15 percen belül | Napok egy lekérdező megírásával |
| Elérhetőség | Professional szint és magasabb | Csak Enterprise API-hozzáféréssel |
| booking.created | ||
| booking.updated | ||
| booking.cancelled | ||
| payment.succeeded | ||
| HMAC-SHA256 aláírások | Enterprise kiegészítő | |
| Újrapróbálkozási stratégia | Exponenciális visszalépés, 72 órás ablak | Egyetlen kísérlet vagy semmi |
| Kézbesítési napló visszajátszással | ||
| Támogatás | Fejlesztői csapat Slacken | E-mailes jegykezelő sor |
Szabványos minták — semmi egzotikus, semmi saját fejlesztésű.
Fejlesztői csapatok, akik élesben használják a Triviyo webhookokat
“Kitöröltünk 400 sor lekérdező kódot azon a napon, amikor a Triviyo webhookok megjelentek. A booking.created egy másodpercen belül megérkezik az adatraktárunkba — az attribúciós és bevételi dashboardok végre valós idejűek, nem 15 perccel késnek.”
“A kézbesítési napló az alábecsült hős. Amikor a Slack-integrációnk egy ünnepnap meghibásodott, visszajátszottam a 30 kihagyott eseményt a dashboardról, miközben a platformcsapatunk szabadságon volt. Adatvesztés nem volt, eszkalációra sem volt szükség.”
Gyakran ismételt kérdések
Milyen eseményekre iratkozhatok fel?
Induláskor: booking.created, booking.updated, booking.cancelled és payment.succeeded. További eseményeket (payment.refunded, waiver.signed, checkin.completed, gift_card.redeemed) folyamatos frissítések keretében szállítunk. Végpontonként iratkozz fel pontosan azokra, amelyekre az integrációdnak szüksége van.
Hogyan ellenőrzöm, hogy a webhook valóban a Triviyo-tól érkezett?
Minden payloadot HMAC-SHA256 algoritmussal írunk alá a végpontod egyedi titkos kulcsával. Ellenőrizd az X-Triviyo-Signature fejlécet a nyers kérés törzsével szemben, mielőtt bármit tennél — ugyanaz a minta, mint a Stripe és a GitHub webhookoknál. Kódpéldák elérhetők a dokumentációban.
Mi történik, ha a végpontom nem elérhető?
A Triviyo exponenciális visszalépéssel újrapróbálkozik, akár 72 órán át — először 1 perc után, majd 5, 25, 2 óra, 6 óra, 24 óra. Ezután az esemény a kézbesítési naplóba kerül, ahonnan manuálisan visszajátszhatod, amint a végpontod újra elérhető.
Tesztelhetem a webhookokat staging környezetben?
Igen. Minden csomag tartalmaz tesztmódot, saját webhook-végpontokkal és szimulált eseményekkel. Aktiválj bármely eseményt a dashboardról az integráció ellenőrzéséhez az élesítés előtt — és játszd vissza annyiszor, amennyiszer szükséges.
Melyik csomag szükséges a webhookokhoz?
Professional szint és magasabb. A Starter csomagok teljes hozzáférést biztosítanak a dashboardhoz és a riportokhoz; a webhookok a Professional szinttől nyílnak meg, mert az oldalunkon tartós infrastrukturális befektetést igényelnek a késési és kézbesítési garanciák teljesítéséhez.
Van-e sebességkorlát?
Nincs kemény sebességkorlát — örömmel kézbesítünk percenként több száz eseményt a végpontodra. Ha a végpontod nehezen birkózik meg a terheléssel, automatikusan lelassulunk és újrapróbálkozunk, ahelyett hogy eseményeket ejtenénk.
Építs valós idejű integrációkat lekérdezés nélkül
Állítsd be az első webhook-végpontodat 15 perc alatt. Aláírva, újrapróbálva, naplózva — pontosan úgy, ahogy a fejlesztői csapatok elvárják.
14 napos ingyenes próba. Bankkártya nem szükséges. Bármikor lemondható.