Exhibitions

Eine Exhibition in go~mus ist eine Sonderausstellung - die kuratierte Schau mit Laufzeit, an der Tickets, Events und Tours hängen können. Auf den meisten Resource-Listen taucht exhibition_id als Filter auf; diese Resource liefert die Werte und die Detaildaten für öffentliche Anzeigen.

Vollständige Endpoint- und Schema-Referenz: Swagger.

Endpoints im Überblick

Endpoint	Wofür
`GET /api/v4/exhibitions`	Liste aller Sonderausstellungen
`GET /api/v4/exhibitions/:id`	Detail mit Laufzeit-Frames und Content

Anatomie eines Exhibition-Objekts

id - stabil, nutzt das in by_exhibition_ids[]-Filtern überall
museum_id - zu welchem Haus die Ausstellung gehört
foreign_id - optional, deine externe ID (z.B. CMS-Artikel-Slug)
title, sub_title, description - übersetzbar via ?locale=de
featured - Boolean, Highlight-Flag
picture - URL zum Hauptbild
content - Langtext-HTML für Detail-Seiten
time_frames - Array von { from, to }-Paaren mit den Laufzeiten der Ausstellung. Eine Ausstellung kann mehrere disjunkte Frames haben (Pause, Verlängerung)

Komplette Feldliste: Swagger.

Häufige Aufgaben

Sonderausstellungen auflisten

curl "https://demo.gomus.de/api/v4/exhibitions?by_museum_ids[]=20&by_featured=true&locale=de"

Filter:

by_museum_ids[] - nur Ausstellungen eines Hauses
by_featured=true - nur Highlights

Detail

curl "https://demo.gomus.de/api/v4/exhibitions/2057?locale=de"

Liefert Description, content und time_frames - genug für eine vollständige Detail-Seite mit Laufzeit-Anzeige.

Beziehungen

Exhibition
 ├── Museum ............. zu welchem Haus
 ├── Tickets ............ per exhibition_ids
 ├── Events ............. per exhibition_id
 └── Tours .............. per exhibition_id

Stolperdrahte

exhibition_id = -1 als Filter ist eine Sonderform. In by_exhibition_ids[] bedeutet -1 "Treffer ohne Ausstellungsbezug" - nützlich für Sammlungs-Tickets oder Sammlungs-Events, die zu keiner laufenden Sonderausstellung gehören.
time_frames kann mehrere Einträge haben. Eine Ausstellung mit Pause und Verlängerung hat zwei Frames. Wenn "läuft gerade" angezeigt werden soll, prüfst du alle Frames, nicht nur den ersten.
foreign_id als Lookup im URL-Path geht. GET /api/v4/exhibitions/:id versucht zuerst die numerische ID, fällt dann auf foreign_id zurück. Wenn eure CMS-IDs zufällig wie numerische go~mus-IDs aussehen (12345), kann das zu Verwechslungen führen - präfixierte foreign_ids (HKW-2026, LWL-WI23) sind robuster.