Diese Sektion ist für alle, die go~mus mit eigenen Systemen verbinden - Webseiten, Apps, Backends, Reseller-Plattformen. Wir empfehlen den Einstieg über den Quickstart, danach Konzepte und Authentifizierung. Konkrete End-to-End-Use-Cases findest du unter Szenarien.
API Quickstart
Erster Aufruf gegen die go~mus REST-API in fünf Minuten - Auth, whoami, Versionscheck und ein paginierter Index.
Weiterlesen →Konzepte
Die Vokabeln der go~mus-API in einem Sprung erklärt - Instance, Mandantentrennung, Stammdaten vs. Live-Daten, Tokens, Quotas, Reservations, Orders.
Weiterlesen →Authentifizierung
Wie Authentifizierung an der go~mus-API funktioniert - Bearer-Tokens, Kontextsensitivität, foreign_id-Pattern, Best Practices.
Weiterlesen →Tickets
Eintrittstickets - Tagestickets, Zeitfenster-Tickets, Kombi-Tickets. Listen, Verfügbarkeiten prüfen, reservieren und in eine Bestellung einbetten.
Weiterlesen →Annual Tickets
Jahreskarten - Personalisierungs-Flow nach dem Kauf, Token-basierter Zugriff, Customer-Create und Personalisierungs-Update.
Weiterlesen →Events (Veranstaltungen)
Veranstaltungen mit konkreten Terminen (Dates). Wie sich Kalender bauen lassen, Filter anwenden und der Weg vom Termin zur Buchung führt.
Weiterlesen →Tours (Führungen)
Geführte Touren - listen, Verfügbarkeit prüfen, Preise berechnen, und über Anfrage oder Direktbuchung anstoßen.
Weiterlesen →Reservations
Temporäre Plätze für Tickets - Lebensdauer, Refresh-Mechanik, was bei Ablauf passiert. Warum es Reservations nur für Tickets gibt.
Weiterlesen →Orders
Bestellungen post-create - auflisten, finden (auch via Barcode), zwei-phasig finalisieren, stornieren. Der Lebenszyklus, den Reseller und Backoffice-Tools brauchen.
Weiterlesen →Customers
Kund:innen-Daten in go~mus - mit foreign_id als Brücke zu deinem CRM. Anlegen, finden, aktualisieren, ohne dass dein und unser System auseinanderlaufen.
Weiterlesen →Requests
Anfragen-Endpunkt für Gruppenbuchungen - Schulklassen, Gruppen, Seniorengruppen über ein Webformular zu einer go~mus-Anfrage machen.
Weiterlesen →Coupons
Wertgutscheine - Liste, Detail, Versandkosten-Verknüpfung. Ein eigener Produkttyp parallel zu Tickets, Events und Tours.
Weiterlesen →Museums
Häuser einer go~mus-Instance - listen, Detail abrufen, Öffnungszeiten ermitteln. Referenzdaten für Filter und Anzeigen.
Weiterlesen →Exhibitions
Sonderausstellungen - listen, Detail mit Laufzeiten, als Filter über Tickets, Events und Tours.
Weiterlesen →Lookups
Stammdaten-Tabellen für Konstanten - Länder, Bundesländer, Versandarten, Anreden, Titel. Cachen und einmal pro Tag aktualisieren.
Weiterlesen →Errors
HTTP-Status-Codes, Body-Format und Retry-Strategie - was die go~mus API im Fehlerfall zurückgibt und wie du darauf sauber reagierst.
Weiterlesen →Multi-Locale
Mehrsprachige Inhalte in einem Roundtrip - wie sich DE und EN gleichzeitig holen lassen, welche Permission nötig ist, und wie Fallbacks greifen.
Weiterlesen →Best Practices
Caching, Fehlerbehandlung, Pagination, Rate-Limits, Logging - was eine produktive Integration von einer unterscheidet, die dreimal neu gebaut werden muss.
Weiterlesen →Vollständige API-Referenz
OpenAPI-Spec pro Instanz unter /api-docs/ (Swagger-UI, public).
Öffnen →