Entwicklerdokumentation

Venue

Die sieben GETs für eine vollständige Location – Profil, Geschäftsdaten, Öffnungszeiten, Speisekarten, Specials, Ressourcen, Raumplan, je eine Seite.

Sieben Lesezugriffe beschreiben eine Location vollständig. Sie sind günstig, auf Ihrer Seite cachebar und ändern sich nur, wenn der Betreiber etwas in der Konsole bearbeitet. Alle nehmen den Slug der Location im Pfad, brauchen einen Schlüssel (Schlüssel und Header) und antworten mit 404 und einem Problem-Body, wenn keine Location diesen Slug hat. Jeder Lesezugriff hat unten seine eigene Seite, mit Antwortfeldern, einem JSON-Beispiel und Anfragebeispielen in drei Sprachen.

Endpunkte

Seite Endpunkt
Profil GET /api/venues/{venueSlug}
Geschäftsdaten GET /api/venues/{venueSlug}/business-info
Öffnungszeiten GET /api/venues/{venueSlug}/opening-hours
Speisekarten GET /api/venues/{venueSlug}/menus
Specials GET /api/venues/{venueSlug}/specials
Ressourcen GET /api/venues/{venueSlug}/resources
Raumplan GET /api/venues/{venueSlug}/floor-plan

Caching

Keine dieser Antworten trägt einen Cache-Header, weil der Betreiber sie jederzeit ändern kann. Eine vernünftige Integration cacht sie Minuten, nicht Tage, und lädt bei 404 oder einem unbekannten Schema neu. Das Widget selbst liest Profil und Raumplan einmal pro Seitenaufruf und cacht nichts über Seitenaufrufe hinweg.

Nächste Schritte

  • Verfügbarkeit – aus Ressourcentyp und Datum buchbare Slots machen.
  • .NET-SDK – dieselben sieben Lesezugriffe als typisierte Methoden.