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
Mehrere Locations mit einem Konto betreiben
Locations zu Premium hinzufügen, je Schlüssel und Widget vergeben, per Header wählen, ein Login auf eine Filiale beschränken und die Downgrade-Sperre verstehen.
Ein BookDinePlay-Konto (ein Mandant) kann mehrere Locations besitzen – eine Bar-Gruppe, ein Restaurant mit separatem Spielraum, Franchise-Filialen –, jede mit eigenem Slug, eigenen Öffnungszeiten, Ressourcen, Menüs, Events und Schlüsseln. Dieses Tutorial zeigt, wie die Teile zusammenpassen: eine Location hinzufügen, mehrere auf einer Website einbetten, die Location in Betreiberanfragen wählen, ein Login auf eine Filiale beschränken und was bei einem Downgrade geschieht.
Mehrere Locations brauchen den Tarif Premium, der bis zu 25 erlaubt. Starter und Pro haben eine Location; eine weitere hinzuzufügen antwortet 403 feature-not-in-plan mit requiredPlan: "Premium", und am Limit 409 venue-limit-reached mit dem geltenden maxVenues.
1. Eine Location hinzufügen
Fügen Sie in der Konsole eine Location hinzu, oder bitten Sie Ihren Assistenten über MCP: venues_list zeigt, was das Konto hat, venues_create fügt eine weitere Location im Rahmen des Tariflimits hinzu, und venue_create legt die allererste an. Der Slug ist die dauerhafte Adresse der Location in der API und wird einmal festgelegt. Alles andere – Profil, Zeiten, Ressourcen, Menüs, Events, Gutscheine, QR-Codes, Nachrichten – gehört zu einer Location und wird mit dieser ausgewählten Location bearbeitet.
Die älteste Location (nach Anlage, dann Slug) ist die Standard-Location des Kontos: Auf sie bezieht sich jede Betreiberanfrage, die keine andere nennt.
2. Jeder Location einen eigenen Schlüssel geben
API-Schlüssel gelten pro Location. Ein Schlüssel einer Location auf der Route einer anderen wird mit venue-mismatch abgelehnt; eine Website, die mehrere Locations einbettet, trägt also einen veröffentlichbaren Schlüssel pro Location. Legen Sie jeden Schlüssel unter seiner eigenen Location an (Location → API-Schlüssel mit dieser Location ausgewählt) und erlauben Sie die Origins, von denen die Seiten dieser Location ausgeliefert werden.
Auf einer Seite mit zwei Locations bekommt jedes Widget seine eigene Location und seinen Schlüssel:
<div id="bar-widget"></div>
<div id="lounge-widget"></div>
<script src="https://cdn.bookdineplay.com/sdk/v1/bookdineplay.js"></script>
<script>
window.BookDinePlay.renderBookingWidget({
container: '#bar-widget',
venueSlug: 'harbour-bar',
apiBaseUrl: 'https://api.bookdineplay.com',
publishableKey: 'bdp_pk_key_of_harbour_bar'
});
window.BookDinePlay.renderBookingWidget({
container: '#lounge-widget',
venueSlug: 'harbour-lounge',
apiBaseUrl: 'https://api.bookdineplay.com',
publishableKey: 'bdp_pk_key_of_harbour_lounge'
});
</script>In WordPress gibt es dafür das Shortcode-Attribut key: [bookdineplay_widget venue="harbour-lounge" key="bdp_pk_…"]; der Schlüssel in den Einstellungen ist der Standard für Shortcodes, die keinen nennen. Eine serverseitige Integration hält auf dieselbe Weise einen geheimen Schlüssel pro Location.
3. Die Location in Betreiberanfragen wählen
Die Betreiber-API – was die Konsole und der MCP-Server aufrufen, authentifiziert als angemeldete Person – wirkt pro Anfrage auf eine Location. Nennen Sie sie mit einem Header:
GET /api/operator/venue HTTP/1.1
Authorization: Bearer <the operator's access token>
X-BookDinePlay-Venue: harbour-lounge| Was Sie senden | Was geschieht |
|---|---|
| Den Header mit dem Slug einer Ihrer Locations | Die Anfrage wirkt auf diese Location (Groß-/Kleinschreibung egal) |
| Keinen oder einen leeren Header | Sie wirkt auf Ihre Standard-Location |
| Einen Slug, der keine Location Ihres Kontos ist – unbekannt oder von einem anderen Konto | 404 venue-not-found; die Antwort ist in beiden Fällen gleich, sie verrät also nie, welcher es war |
| Eine Schwester-Location, die Ihr Login nicht nutzen darf | 403 venue-not-permitted |
Jede Antwort, die auf eine Location gewirkt hat, spiegelt X-BookDinePlay-Venue mit dem verwendeten Slug zurück, sodass ein Client es prüfen kann. GET /api/operator/venues listet die Locations, die der Aufrufer wählen darf, mit der Standard-Location und dem maxVenues des Tarifs; GET /api/operator/me meldet dasselbe und ist gegenüber einem fehlerhaften Header bewusst nachsichtig, sodass sich ein Client mit veralteter Auswahl immer erholen kann. Ein Konto mit einer Location braucht den Header nie.
Über MCP ist der Header das Argument venue jedes Location-Werkzeugs. Fehlt es bei einem Konto mit mehreren Locations, lehnt das Werkzeug ab und nennt die Auswahl.
4. Ein Login auf eine Filiale beschränken
Ein Login lässt sich auf eine einzige Location beschränken: Die Managerin der Lounge soll nur die Lounge sehen und ändern. Ein kontoweiter Betreiber darf jede Location nutzen, ein beschränkter nur seine eigene, die zugleich sein Standard ist, egal ob er den Header sendet. Eine Schwester-Location zu nennen antwortet 403 venue-not-permitted.
Heute wird die Beschränkung gesetzt, wenn der BookDinePlay-Support den Betreiber anlegt oder aktualisiert, nicht in der Konsole: Bitten Sie ihn, die Location eines Betreibers zu setzen oder wieder aufzuheben. Ein beschränktes Login kann außerdem nicht, was zum ganzen Konto gehört – Abrechnung, Auszahlungs-Onboarding, eine Location hinzufügen –, was 403 tenant-operator-required antwortet, und es kann die Nutzungsbedingungen und den Auftragsverarbeitungsvertrag nicht für das Konto annehmen: Es sieht den Hinweis, dass der Kontoinhaber das tun muss.
5. Was ein Downgrade bewirkt
Erlaubt der Tarif später weniger Locations, bleiben die ältesten bis zum neuen Limit voll nutzbar, und die übrigen sind gesperrt; ein Upgrade entsperrt alles auf einmal, weil nichts gespeichert wird – die Sperre wird bei jeder Anfrage aus Rang und Tarif berechnet.
| Bereich | Eine gesperrte Location |
|---|---|
| Betreiber-Lesezugriffe | Funktionieren; ihre Daten bleiben lesbar |
| Betreiber-Änderungen | 403 venue-not-in-plan |
Öffentliche /api/venues/** |
403 tenant-suspended, genau wie bei einem ausgesetzten Konto |
| Venue-Verzeichnis der BookDinePlay-App, Tisch-QR-Codes | Verschwunden, und QR-Codes lösen nicht mehr auf |
| Tickets, Anmeldungen, Stornolinks, Gutschein-Abruf, Gutschein-Einlösung am Tisch | Funktionieren weiter: Gäste halten diese Credentials bereits |
Nächste Schritte
- Fehler – jedes Multi-Location-Problem und seine Lösung.
- Authentifizierung – Schlüsseltypen und Origins.
- MCP-Werkzeuge – das Argument
venueundvenues_create.