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
Öffnungszeiten
Den Wochenplan und datumsbezogene Ausnahmen für Feiertage, Veranstaltungen und früheren Schluss lesen – zum Anzeigen, nicht zum Berechnen.
Der Wochenplan plus datumsbezogene Ausnahmen (Feiertage, Veranstaltungen, früherer Schluss). Die Verfügbarkeit wendet sie bereits an; lesen Sie sie, um Öffnungszeiten anzuzeigen, nicht um Slots zu berechnen. Er folgt denselben Schlüsselregeln wie der Rest von /api/venues/** (Schlüssel und Header) und antwortet mit 404 und einem Problem-Body, wenn keine Location diesen Slug hat.
Endpunkte
GET /api/venues/{venueSlug}/opening-hours
Antwort 200 OK
| Feld | Typ | Bedeutung |
|---|---|---|
slug, timezone |
string | Die Location und die Zone, in der die Zeiten liegen |
regular |
object[] | Ein Eintrag je Wochentag: day (Monday…Sunday), isClosed, opens, closes (HH:mm, null wenn geschlossen) |
special |
object[] | Datumsausnahmen: date (yyyy-MM-dd), isClosed, opens, closes, note – ein Eintrag gewinnt an seinem Datum über den Wochentag |
Zeiten über Mitternacht hinweg (opens 18:00, closes 02:00) gehören zu dem Tag, an dem sie beginnen: das ist der Geschäftstag, und eine Buchung um 01:00 an ihm liegt auf dem Kalendertag danach. Die Verfügbarkeit kennzeichnet diese Slots mit startsNextDay und kann am Folgetag auch den Rest der Vornacht anbieten.
Pausen werden nur an Tagen angewendet, die vor Mitternacht schließen.
{
"slug": "demo-sportsbar",
"timezone": "Europe/Berlin",
"regular": [
{
"day": "Monday",
"isClosed": true,
"opens": null,
"closes": null
},
{
"day": "Tuesday",
"isClosed": false,
"opens": "16:00",
"closes": "23:00"
},
{
"day": "Wednesday",
"isClosed": false,
"opens": "16:00",
"closes": "23:00"
}
],
"special": [
{
"date": "2026-12-24",
"isClosed": true,
"opens": null,
"closes": null,
"note": "Christmas Eve — closed"
},
{
"date": "2026-12-31",
"isClosed": false,
"opens": "18:00",
"closes": "02:00",
"note": "New Year's Eve — late night"
}
]
}Fehler – 404 keine Location mit diesem Slug.
curl
curl "https://api.bookdineplay.com/api/venues/your-venue/opening-hours" \
-H "X-BookDinePlay-Key: bdp_pk_your_publishable_key" \
-H "Origin: https://www.your-venue.example"JavaScript
const hours = await (await fetch('https://api.bookdineplay.com/api/venues/your-venue/opening-hours', {
headers: { 'X-BookDinePlay-Key': 'bdp_pk_your_publishable_key' }
})).json();
for (const day of hours.regular) {
console.log(day.day, day.isClosed ? 'geschlossen' : `${day.opens}–${day.closes}`);
}C#
var hours = await client.GetOpeningHoursAsync("your-venue", cancellationToken);PHP
<?php
$response = wp_remote_get( 'https://api.bookdineplay.com/api/venues/your-venue/opening-hours', [ 'headers' => [ 'X-BookDinePlay-Key' => BOOKDINEPLAY_SECRET_KEY ] ] );
$hours = json_decode( wp_remote_retrieve_body( $response ), true );
foreach ( $hours['regular'] as $day ) {
echo $day['day'] . ' ' . ( $day['isClosed'] ? 'closed' : "{$day['opens']}-{$day['closes']}" ) . "\n";
}Nächste Schritte
- Venue – die übrigen sechs Lesezugriffe dieser Location.
- Verfügbarkeit – die Slots, die diese Öffnungszeiten bereits einschränken.
- .NET-SDK – derselbe Lesezugriff als typisierte Methode.