Plattform-Anbindung

go~mus an externe Plattformen anbinden - Reseller-Marktplätze über ExperienceBank, museumseigene Buchungsportale und Apps direkt über die API.

go~mus als Plattform anzubinden ist ein häufiger Integrationsfall: Reseller-Marktplätze (OTAs wie GetYourGuide, Tiqets, Musement, Klook, regionale Tourismus-Plattformen), museumseigene Buchungsportale, Apps unter Museumsregie, White-Label-Lösungen. Diese Seite trennt die zwei Wege und zeigt, wo welcher passt.

Empfohlen: ExperienceBank als Channel-Manager

ExperienceBank ist ein Channel-Manager, spezialisiert auf Museen und Attraktionen. Eine Anbindung, viele Reseller. ExperienceBank pflegt die Verbindungen zu den großen OTAs zentral und routet Inventar, Preise und Bestellungen zu den jeweiligen Reseller-Plattformen.

Wer für wen passt.

  • Neue Museen, die Reseller-Vertrieb anfangen oder ausbauen möchten
  • Häuser, die mehrere Reseller bedienen wollen, ohne pro Reseller ein eigenes Integrations-Projekt zu führen
  • Häuser, die operative Entlastung suchen: Inventory, Preise, Verfügbarkeiten zentral statt parallel pro Vertriebspartner

Flow.

1. Setup mit ExperienceBank besprechen, Inventar und Preise definieren.

2. ExperienceBank verbindet sich mit eurer go~mus-Instanz.

3. Reseller-Plattformen werden über ExperienceBank aktiviert, nicht über separate API-Anbindungen pro Reseller.

→ Partner-Seite mit Listing-Eintrag und Link zu ExperienceBank.

Direkte API (eigene Buchungswege, kein Reseller)

Die go~mus-API ist auch direkt nutzbar - aus eurer Webseite, aus einer App, oder aus einem speziellen, von euch betriebenen Buchungsweg (Erlebnis-Pakete, B2B-Vermittlung, White-Label-Plattform unter Museumsregie). Für klassische Reseller (OTAs, externe Vertriebsplattformen) bitte immer ExperienceBank nutzen, nicht die Direkt-API.

Wann die direkte API passt.

  • Direkte Bestellerstellung aus eurer Museums-Webseite, ohne Umweg über den Standard-Shop
  • Eine vom Museum betriebene App oder ein spezielles Buchungsportal
  • White-Label-Plattformen, die ihr selbst betreibt und in eurer Verantwortung hängen

Flow. Im Wesentlichen die normale go~mus-API mit einem Reseller-Token statt einem User-Token. Der Token entscheidet, was sichtbar ist und welche Aktionen erlaubt sind.

1. Stammdaten lesen - Tickets, Events, Tours, Coupons, Museums, Exhibitions.

2. Verfügbarkeiten live prüfen - capacity-Endpunkte und Date-Detail-Seats. Cache-Strategie ist Pflicht, siehe Best Practices.

3. Optional: Reservation - Reservations, wenn ein Reseller-Checkout etwas Lebenszeit auf Plätzen braucht.

4. Order anlegen und finalisieren - Orders, zwei-phasiges Reseller-Pattern (POST /orders → POST /orders/:id/finalize).

5. Stornieren - bei Bedarf einzelne Items oder die ganze Order, siehe Orders: Stornieren.

6. Dokumente abholen - Ticket-PDFs, Passbook, Event-PDFs, Tour-PDFs, Rechnungen.

Reseller-spezifische Patterns.

  • Token-Kontextsensitivität - Reseller-Tokens geben gefilterten Zugriff: nur die für diesen Reseller freigegebenen Tickets, Events, Tours. Antworten unterscheiden sich vom User-Token. Details in Authentifizierung.
  • Rate-Limits - Reseller-Tokens haben Rate-Limits. 429 bedeutet zu viele Requests; exponential Backoff. Mehr in Best Practices.
  • foreign_id für Customer- und Order-Mapping - Reseller hält die Kunden-ID (foreign_id) und die Order-Referenz (reference) selbst, go~mus übernimmt beides. Spätere Lookups laufen über den eigenen Schlüssel, nicht über go~mus-IDs. Pattern in Customers.

Stolperdrahte.

  • Storno aller Items ≠ Storno der Order. Wer alle Items einzeln storniert, hat noch keine stornierte Order. Der Cancel der Order ist ein eigener Aufruf - explizit in Orders erklärt.
  • Reservations sind nicht idempotent. Bei Timeout nicht versuchen, die alte Reservation zurückzuholen - sie läuft nach 5 Minuten von selbst aus. Neuen Capacity-Check + neue Reservation. Mehr in Best Practices.
  • Preisberechnung server-validiert. Wer den total selbst berechnet, muss die Stammdaten-Preise verwenden, nicht eigene Listenpreise. Sonst lehnt der Server die Order ab. Hintergrund in Best Practices.

Welcher Weg passt für was

SituationEmpfehlung
Reseller-Vertrieb (OTAs, externe Plattformen)ExperienceBank
Direkte Bestellungen aus eurer Webseite oder AppDirekt-API
Vom Museum betriebenes Buchungsportal, Erlebnis-PaketDirekt-API
White-Label-Plattform unter MuseumsregieDirekt-API

Im Zweifel: support@giantmonkey.de fragen.

Verwandte Seiten