Bookora

Rajapinta ja webhookit

REST-rajapinta omille järjestelmille ja tapahtumailmoitukset reaaliajassa.

Tällä sivulla

API-avaimet

Luo avain kohdassa Upotus ja rajapinta → API-avaimet.

  • Julkinen avain (pk_bko_…) vain lukemiseen, esimerkiksi saatavuuden näyttämiseen selaimessa.
  • Salainen avain (sk_bko_…) palvelimelle: varausten luonti ja peruminen sekä passit.

Avain annetaan otsakkeessa Authorization: Bearer AVAIN. Rajapinnan kuvaus esimerkkeineen on sivulla Kehittäjille.

⚠️ Salainen avain näytetään vain kerran luonnin yhteydessä. Älä koskaan laita sitä verkkosivun koodiin. Jos avain vuotaa, peru se ja luo uusi.

Webhookit

Bookora lähettää tapahtumat valitsemaasi osoitteeseen heti: booking.created, booking.confirmed, booking.updated, booking.cancelled, pass.created, pass.renewed, pass.cancelled, access.granted ja payment.received.

  • Jokaisessa kutsussa on otsake x-bookora-event ja allekirjoitus x-bookora-signature muodossa t=aikaleima,v1=HMAC-SHA256.
  • Allekirjoitus lasketaan webhookin salaisuudella merkkijonosta aikaleima.runko.
  • Epäonnistunut toimitus yritetään uudelleen 1, 5, 30, 120 ja 720 minuutin kuluttua.
Etkö löytänyt vastausta? Kirjoita meille osoitteeseen tuki@bookora.fi, niin autamme. Vastaamme arkisin yleensä saman päivän aikana.