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. 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);

Nächste Schritte

  • Venue – die übrigen fünf Lesezugriffe dieser Location.
  • Verfügbarkeit – die Slots, die diese Öffnungszeiten bereits einschränken.
  • .NET-SDK – derselbe Lesezugriff als typisierte Methode.