Bookora

API und Webhooks

REST-API für eigene Systeme und Ereignisbenachrichtigungen in Echtzeit.

Auf dieser Seite

API-Schlüssel

Erstellen Sie einen Schlüssel unter Einbettung und API → API-Schlüssel.

  • Öffentlicher Schlüssel (pk_bko_…) nur lesend, z. B. für die Anzeige freier Zeiten im Browser.
  • Geheimer Schlüssel (sk_bko_…) für Server: Buchungen anlegen und stornieren sowie Pässe.

Der Schlüssel wird im Header Authorization: Bearer SCHLÜSSEL übergeben. Die API-Beschreibung mit Beispielen finden Sie unter Für Entwickler.

⚠️ Der geheime Schlüssel wird nur einmal beim Erstellen angezeigt. Setzen Sie ihn nie in Website-Code ein. Gelangt er an die Öffentlichkeit, widerrufen Sie ihn und erstellen einen neuen.

Webhooks

Bookora sendet Ereignisse sofort an Ihre Adresse: booking.created, booking.confirmed, booking.updated, booking.cancelled, pass.created, pass.renewed, pass.cancelled, access.granted und payment.received.

  • Jeder Aufruf enthält den Header x-bookora-event und die Signatur x-bookora-signature im Format t=Zeitstempel,v1=HMAC-SHA256.
  • Die Signatur wird mit dem Webhook-Geheimnis aus der Zeichenkette Zeitstempel.Body berechnet.
  • Fehlgeschlagene Zustellungen werden nach 1, 5, 30, 120 und 720 Minuten wiederholt.
Keine Antwort gefunden? Schreiben Sie uns an tuki@bookora.fi, wir helfen gern. Wir antworten meist am selben Werktag.