Anmelden um den Slug und den veröffentlichbaren Schlüssel Ihrer Location in jedem Beispiel zu sehen.
Ihr Konto hat noch keine Location, die Beispiele behalten daher ihre Platzhalter. Abmelden
Angemeldet als · . Legen Sie in der Konsole einen veröffentlichbaren Schlüssel an und laden Sie die Seite neu, um ihn hier zu sehen. Abmelden
Angemeldet als · . Die Beispiele zeigen den veröffentlichbaren Schlüssel Ihrer Location. Abmelden
Entwicklerdokumentation
JavaScript-Schnellstart
Ein Buchungswidget auf eine Webseite setzen und bei Bedarf auf den Headless-Client für ein eigenes Formular wechseln – mit veröffentlichbarem Schlüssel.
Sie setzen das BookDinePlay-Buchungswidget auf eine Webseite und führen, wenn Sie lieber ein eigenes Formular haben, dieselbe Buchung per Code mit dem Headless-Client aus. Sie brauchen eine Seite, die Sie kontrollieren, einen Location-Slug und einen veröffentlichbaren Schlüssel.
1. Veröffentlichbaren Schlüssel anlegen
Öffnen Sie in der Konsole Location → API-Schlüssel und legen Sie einen Schlüssel vom Typ Veröffentlichbar an. Tragen Sie jede Origin ein, von der Ihre Seite ausgeliefert wird, genau so, wie der Browser sie schreibt – für die Entwicklung zusätzlich http://localhost:*:
https://www.your-venue.example
http://localhost:*Ein veröffentlichbarer Schlüssel darf in HTML stehen: Die Origin-Liste schützt ihn, nicht Geheimhaltung. Setzen Sie nie einen geheimen Schlüssel (bdp_sk_…) in eine Seite; das SDK startet mit einem solchen nicht.
2. Widget einfügen
An beliebiger Stelle der Seite:
<div id="bookdineplay-widget"></div>
<script src="https://cdn.bookdineplay.com/sdk/v1/bookdineplay.js"></script>
<script>
window.BookDinePlay.renderBookingWidget({
container: '#bookdineplay-widget',
venueSlug: 'your-venue',
apiBaseUrl: 'https://api.bookdineplay.com',
publishableKey: 'bdp_pk_your_publishable_key',
resourceTypes: ['RestaurantTable', 'BilliardTable', 'DartBoard']
});
</script>Liefern Sie die Seite von einer erlaubten Origin aus – nicht von file://, dessen Origin: null nie auf einer Liste stehen kann – und öffnen Sie sie. Das Widget fragt Personenzahl, Datum und Uhrzeit ab, listet die freien Slots, sammelt die Kontaktdaten und bestätigt mit einer Referenz wie BDP-7Q2M4K. Das JavaScript-SDK listet alle Optionen, und mit Theming passen Sie das Aussehen an.
3. Oder Ihr eigenes Formular behalten
Das Widget läuft auf einem Headless-Client, den Sie direkt nutzen können. Laden Sie dasselbe Script und führen Sie die zwei Aufrufe aus, die eine Buchung braucht: freie Slots abfragen, einen buchen.
const client = window.BookDinePlay.createClient({
apiBaseUrl: 'https://api.bookdineplay.com',
publishableKey: 'bdp_pk_your_publishable_key',
venueSlug: 'your-venue'
});
// Welche Zeiten sind morgen für vier Personen frei?
const tomorrow = new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString().slice(0, 10);
const availability = await client.availability({
date: tomorrow,
partySize: 4,
resourceType: 'RestaurantTable'
});
const slot = availability.slots.find((s) => s.available);
// Buchen. Ein Idempotency-Key pro Versuch macht eine Wiederholung sicher.
const reservation = await client.reserve(
{
resourceType: 'RestaurantTable',
resourceId: slot.resourceId,
date: availability.date,
start: slot.start,
partySize: 4,
customerName: 'Jana Berger',
email: 'jana@example.com'
},
{ idempotencyKey: crypto.randomUUID() }
);
console.log(reservation.reference, reservation.status);Führen Sie es in einem <script type="module"> (für await auf oberster Ebene) oder in einer async-Funktion aus. reservation.status ist Confirmed oder Pending, wenn die Location eine Anzahlung verlangt (Anzahlungen). Der Gast erhält die Bestätigungs-E-Mail.
Prüfen, ob es geklappt hat
Öffnen Sie die Konsole unter app.bookdineplay.com: Die Buchung steht mit der protokollierten Referenz in der Reservierungsliste. Stornieren Sie sie dort, um den Slot wieder freizugeben.
Wenn es nicht funktioniert
- Nichts wird dargestellt und die Browser-Konsole nennt den Schlüssel.
publishableKeyist Pflicht; das Widget ruft die API nicht ohne auf. 403 origin-not-allowed. Die Origin der Seite steht nicht auf der Liste des Schlüssels. Legen Sie einen neuen Schlüssel mit allen Origins an, rollen Sie ihn aus und widerrufen Sie den alten (Schlüssel rotieren).401 invalid-api-key. Der Schlüssel wurde falsch eingegeben oder widerrufen.409beim Buchen. Der Slot wurde vergeben, nachdem Sie nachgesehen haben: Fragen Sie die Verfügbarkeit erneut ab und bieten Sie den nächsten an.
Nächste Schritte
- Eigene Formulare – ein vollständiges Formular mit Validierung und Fehlerbehandlung auf dem Headless-Client.
- Buchungsablauf – genau, was das Widget in jedem Schritt tut.
- Anzahlungen, Events und Gutscheine – mehr von dem, was dasselbe Script kann.