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.