Entwicklerdokumentation

Überblick

Was die BookDinePlay-Entwicklerplattform bietet, die drei Integrationswege und wo Sie am besten anfangen.

BookDinePlay macht die eigene Website eines Betriebs zu seinem Buchungskanal: Restauranttische, Billardtische, Dartscheiben, Bowlingbahnen und Eventflächen, mit Speisekarten, Öffnungszeiten und optionalen Anzahlungen. Alles, was ein Gast auf Ihrer Website sieht, kommt aus einer öffentlichen API – und jeder Einbettungsweg spricht mit genau dieser API.

Was Sie bauen können

  • Ein Buchungswidget auf jeder Seite. Ein Script-Tag von unserem CDN und ein Funktionsaufruf rendern einen vollständigen, stilisolierten Reservierungsablauf in ein Element Ihrer Wahl. Kein Framework, kein Build-Schritt.
  • Eine WordPress-Website mit Shortcode. Das Plugin lädt dasselbe Widget und stellt [bookdineplay_widget venue="…"] bereit.
  • Ihr eigenes Frontend oder Backoffice. Das typisierte .NET-SDK (BookDinePlay.Sdk auf NuGet) kapselt jeden öffentlichen Endpunkt, und die REST-API steht jeder Sprache offen.

Wie alles zusammenspielt

Baustein Was es ist Wo es läuft
Öffentliche API https://api.bookdineplay.com/api/venues/{slug}/… – Betrieb, Öffnungszeiten, Speisekarten, Ressourcen, Verfügbarkeit, Reservierungen, Zahlungsabsichten BookDinePlay
API-Schlüssel Ein veröffentlichbarer Schlüssel (bdp_pk_…) für Browser, gebunden an die Origins Ihrer Website; ein geheimer Schlüssel für Server Legen Sie in der Konsole an
Widget / Plugin / SDK Der Integrationsweg, den Sie wählen Ihre Website oder Ihr Server

Jeder öffentliche Aufruf trägt einen API-Schlüssel; anonymen Zugriff gibt es nicht. Authentifizierung erklärt die beiden Schlüsseltypen und genau das, was die API ablehnt.

Hier starten

  1. Schnellstart – das Widget in fünf Minuten einbetten.
  2. Authentifizierung – Schlüssel, Origins, Header und Fehler.
  3. Danach die Anleitung für Ihren Stack: JavaScript-SDK, WordPress-Plugin oder .NET-SDK – und das CDN, wenn Sie Versionen festlegen.
  4. API-Referenz – jeder Endpunkt mit einer echten Antwort, wenn Sie ohne die SDKs bauen.
  5. Tutorials – das Widget von Anfang bis Ende, und eine Buchungsseite von null bis live auf Azure.

Häufige Fragen

Ist die Online-Zahlung optional?

Ja. BookDinePlay verlangt für eine Buchung nie eine Zahlung: Eine Reservierung ist im Moment ihrer Erstellung bestätigt – es sei denn, die Location hat Anzahlungen aktiviert, die Ressource trägt einen Anzahlungsbetrag und der Gast hat die Anzahlung angekreuzt; nur dann bleibt sie Pending, bis die Location sie bestätigt. Das Einziehen einer Anzahlung ist ein separater, anbieterunabhängiger Payment Intent, und die API berührt nie Kartendaten.

Brauche ich einen API-Schlüssel?

Ja. Jeder Aufruf von /api/venues/** – auch jede Anfrage des Widgets – muss einen API-Schlüssel im Header X-BookDinePlay-Key (oder als Bearer-Token) tragen; anonymen Zugriff gibt es nicht. Ein veröffentlichbarer Schlüssel (bdp_pk_…) ist im Browser sicher, weil er nur von den Origins funktioniert, die Sie erlauben; ein geheimer Schlüssel (bdp_sk_…) bleibt auf Ihrem Server. Beide legen Betreiber in der Konsole an.

Kann ich es mit WordPress nutzen?

Ja. Das BookDinePlay-WordPress-Plugin, als Zip von jedem GitHub-Release herunterladbar, lädt dasselbe Widget und ergänzt den Shortcode [bookdineplay_widget venue="…"]; Sie hinterlegen den veröffentlichbaren Schlüssel einmal in seinen Einstellungen, nennen die Location im Shortcode, und der Reservierungsablauf erscheint überall dort, wo der Shortcode steht.