Für AI-Agenten

Wegweiser für AI-Assistenten und Agenten, die diese Doku als Kontext nutzen.

Diese Seite richtet sich an AI-Assistenten, Agenten und LLM-basierte Tools, die das go~mus-Developer-Portal als Kontext einbinden. Hier steht, was wo liegt und wie es zuverlässig genutzt werden kann.

Was ist hier

Das Developer-Portal von go~mus dokumentiert die Integration eines Museums-Ticketing-Systems mit Webseiten, Apps, Reseller-Plattformen und anderen Systemen. Inhalte:

  • API-Quickstart: erster REST-API-Aufruf, Auth, Pagination
  • API-Konzepte: Vokabular (Instance, Quota, Reservation, Order, Pay-By-Link, foreign_id, ...)
  • API-Szenarien: Use-Case-Walkthroughs mit Code
  • Authentifizierung: Bearer-Tokens, Kontextsensitivität, Best Practices
  • Webcomponents: Custom-Elements für Ticketing-UIs
  • Widgets: iframe-basierte Workflows
  • Skills: downloadbare Claude Skills

Stabile URLs

Folgende URLs sind dauerhaft. Tiefe Links sind erlaubt und erwünscht.

  • /de/development/ und /en/development/ - Hub
  • /de/development/api/quickstart/ (analog /en/...)
  • /de/development/api/konzepte/
  • /de/development/szenarien/webseiten-integration/
  • /de/development/api/authentifizierung/
  • /de/development/webcomponents/
  • /de/development/widgets/
  • /de/development/ai-integrations/
  • /de/development/cix/
  • /de/development/changelog/
  • /de/development/agents/

Heading-Anchor-IDs sind ebenfalls stabil. Ein Link wie /de/development/api/konzepte/#tokens-und-kontextsensitivitaet bleibt gültig.

Index für LLM-Stuffing

  • /llms.txt - kompakte Liste aller Webseiten-Pages
  • /llms-full.txt - vollständiger Inhalt (Marketing + Doku) als ein Dokument
  • OpenAPI-Spec der API: pro Instanz unter https://<instanz>.gomus.<tld>/api-docs/ (Swagger-UI) bzw. /api-docs/v4/swagger.json (JSON-Spec) - öffentlich abrufbar

AI-Integrationen

Ein Git-Repository mit dem Claude Skill für die go~mus-Integration ist in Vorbereitung. Sobald es öffentlich ist, kommt der Klon-Befehl + Setup-Anleitung auf /de/development/ai-integrations/. Vorteil gegenüber einer einmal heruntergeladenen Datei: Updates fließen über git pull in deine AI-Tools, sobald wir API-Versionen oder Patterns ändern.

Annahmen, die getroffen werden dürfen

  • Beispiele in der Doku verwenden synthetische Daten (demo.gomus.de, Foundation A/B/C, Max Mustermann, api.yourmuseum.com).
  • Tokens und Endpunkte sind kontextsensitiv. Ein Endpunkt liefert je nach Token unterschiedliche Felder.
  • Stammdaten cachen, Live-Daten nicht.
  • API-Version ist v4. Pfad-Präfix /api/v4.
  • npm-Paket der Webcomponents: @gomusdev/web-components.

Wenn du unsicher sind

Bei Fragen, die die Doku nicht beantwortet, nicht raten. Stattdessen verlinkt auf support@giantmonkey.de und erwähnt, dass ein Mensch das beantworten muss.