Webhookit

Allekirjoitetut webhookit jokaiseen varaus- ja maksutapahtumaan

Suoratoista jokainen varaus- ja maksutapahtuma omiin järjestelmiisi — CRM, tietovarasto, Slack, mukautetut integraatiot. HMAC-allekirjoitettu, uudelleenyritetty eksponentiaalisella backoffilla ja täysin lokitettu. Rakennettu suunnittelutiimeille, jotka kieltäytyvät pollaamasta APIa.

14 päivän ilmainen kokeilu. Luottokorttia ei tarvita.

Miksi suunnittelutiimit valitsevat Triviyon webhookit

Vakiokuviot, ennustettava käytös ja toimitusloki, joka oikeasti auttaa virheenjäljityksessä.

HMAC-allekirjoitukset jokaisessa payloadissa

Jokainen webhook allekirjoitetaan HMAC-SHA256:lla käyttäen päätepisteesi salaisuutta. Varmista allekirjoitus ennen payloadiin reagoimista — sama kuvio kuin Stripellä, GitHubilla ja jokaisessa muussa webhookissa, johon jo luotat.

Uudelleenyritykset eksponentiaalisella backoffilla

Jos päätepisteesi ei vastaa ajoissa tai palauttaa tilan 408, 429 tai 5xx, Triviyo yrittää toimitusta automaattisesti uudelleen, yhteensä enintään 6 kertaa. Muut 4xx-vastaukset katsotaan pysyviksi, eikä niitä yritetä uudelleen.

Standardit tapahtumanimet

BOOKING_CREATED, BOOKING_UPDATED, BOOKING_CANCELED, PAYMENT_SUCCEEDED, PAYMENT_FAILED, REFUND_PROCESSED. Tilaa täsmälleen ne tapahtumat, joita integraatiosi tarvitsee; jätä muut huomiotta.

Päätepistekohtaiset allekirjoitusavaimet

Jokaisella päätepisteellä on oma allekirjoitusavain, jonka voit luoda uudelleen milloin tahansa kohdassa Asetukset → Webhookit.

Täydellinen toimitusloki

Jokainen toimitusyritys kirjataan hallintapaneeliin HTTP-tilan, vastauksen ja aikaleiman kanssa.

Triviyon webhookit vs. REST-APIn pollaus

Miltä reaaliaikainen tapahtumasuoratoisto näyttää verrattuna REST-päätepisteen jauhamiseen.

Mitä webhooks-APIin sisältyyTriviyoWithout Triviyo
SaatavuusProfessional-tasosta alkaenVain Enterprise-APIn pääsy
BOOKING_CREATED
BOOKING_UPDATED
BOOKING_CANCELED
PAYMENT_SUCCEEDED
HMAC-SHA256-allekirjoituksetEnterprise-lisäosa
UudelleenyritysstrategiaEnintään 6 yritystäYksi yritys tai ei yhtään
Toimitusloki
TukiEnsisijainen tukiSähköpostin tikettijono

Vakiokuviot — ei mitään eksoottista, ei mitään suljettua.

Usein kysytyt kysymykset

Mitä tapahtumia voin tilata?

BOOKING_CREATED, BOOKING_UPDATED, BOOKING_CANCELED, PAYMENT_SUCCEEDED, PAYMENT_FAILED, REFUND_PROCESSED. Tilaa päätepistekohtaisesti juuri ne, joita integraatiosi tarvitsee.

Miten varmistan, että webhook on oikeasti Triviyosta?

Jokainen payload allekirjoitetaan HMAC-SHA256:lla käyttäen päätepisteesi yksilöllistä salaisuutta. Varmista X-Webhook-Signature-otsake raakaa pyyntöä vasten ennen toimintaa — sama kuvio kuin Stripen ja GitHubin webhookeissa. Koodiesimerkit ovat dokumenteissamme.

Mitä tapahtuu, jos päätepisteeni on alhaalla?

Triviyo tekee yhteensä enintään 6 toimitusyritystä. Viimeisen jälkeen toimitus merkitään toimituslokiin epäonnistuneeksi. Muu 4xx-vastaus kuin 408 tai 429 merkitsee toimituksen heti epäonnistuneeksi ilman uusintayrityksiä.

Voinko testata webhookeja staging-ympäristössä?

Kyllä. Lähetä testitoimitus mihin tahansa päätepisteeseen kohdassa Asetukset → Webhookit ja tarkista integraatiosi ennen käyttöönottoa.

Minkä tason tarvitsen webhookeihin?

Professional-tasosta ja ylöspäin.

Rakenna reaaliaikaisia integraatioita, jotka eivät pollaa

Allekirjoitettu, uudelleenyritetty, lokitettu — juuri niin kuin suunnittelutiimit odottavat webhookien toimivan.

14 päivän ilmainen kokeilu. Luottokorttia ei tarvita. Peruuta milloin tahansa.