Entwickler
Die öffentliche API von Galaxy Hotel Cloud: Verbinden Sie Booking Engine, Channel Manager, POS oder Schließsystem in wenigen Schritten mit einem Betrieb.
Erste Schritte
- 1
Anfrage stellen
Füllen Sie das Formular am Ende der Seite mit Ihrem Unternehmen und dem Produkt aus, das Sie anbinden möchten: Wir prüfen die Anfrage und öffnen Ihnen das Integratoren-Portal.
- 2
In der Testumgebung ausprobieren
Im Portal erzeugen Sie den Product Key Ihres Produkts und den Schlüssel der Testumgebung. GET /v1/me mit beiden Schlüsseln antwortet mit dem Betrieb und den Berechtigungen; von dort aus Zimmertypen, Raten, Verfügbarkeit, Reservierungen.
- 3
Live gehen
Sie füllen das Produktblatt aus (Texte, Logo, angeforderte Berechtigungen) und senden es zur Prüfung. Nach der Freigabe kommt das Produkt in den Marketplace der Hotels: Jedes Hotel aktiviert es, indem es die Berechtigungen akzeptiert, und Sie holen den Schlüssel des Betriebs im Portal oder über die API ab, ohne Kopieren und Einfügen. Das Produktblatt erscheint auch im Marketplace der Website.
Was Sie tun können
Verfügbarkeit und Preise
Freie Zimmer nach Zimmertyp und Nacht, Ratenpläne und Angebote, berechnet von der Preis-Engine des PMS. Für Channel-Manager und Buchungsmaschinen Preise nach Gästezahl, Verkaufsstopp und Mindestaufenthalt Tag für Tag, mit einem Ereignis, wenn sie sich ändern. Für das Schaufenster Fotos, Logo, Beschreibungen in mehreren Sprachen, Leistungen und Größe der Zimmertypen; im Angebot die Kurtaxe, die Stornobedingungen, die Verpflegung und die Anzahlung des Tarifs.
Reservierungen
Erstellen, ändern, bestätigen, stornieren; Zimmer zuweisen; Check-in und Check-out; Gäste im Zimmer mit den Daten für die Meldepflichten. Für Channel-Manager die Buchungen der Portale: nie wegen eines vollen Zimmertyps abgelehnt, auch geändert oder storniert, und was das PMS nicht selbst lösen kann, geht an die Rezeption.
Konten
Die Konten einer Reservierung lesen und Artikel belasten: das, was ein POS tut, wenn der Gast die Rechnung aufs Zimmer schreiben lässt.
Zahlungen
Zahlungsarten des Betriebs, was auf eine Buchung bezahlt wurde und die Erfassung einer anderswo eingenommenen Zahlung, auf dem Vorkonto wie eine Anzahlung; oder ein Zahlungslink des Kartenanbieters des Hotels für Anzahlung, Restbetrag oder Garantie; mit einer eigenen Berechtigung Belastungen und Erstattungen der gespeicherten Karte.
Ereignisse und Webhooks
Erstellte Reservierungen, Check-ins, Check-outs und Stornierungen in ihrer Reihenfolge, per Cursor abrufbar oder über signierte Webhooks an Ihre Adresse zugestellt.
Der erste Aufruf
curl https://api.galaxy-hotel.net/v1/me \
-H "Authorization: Bearer gh_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "X-Product-Key: gh_prod_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
{
"key": { "name": "Booking engine", "scopes": ["availability:read", "reservations:write"] },
"product": { "id": 12, "name": "Booking engine", "company": "Acme Software", "status": "live" },
"property": { "id": 1, "code": "p1", "name": "Hotel Bella Vista" },
"account": { "name": "Bella Vista srl", "plan": "subscription" }
}
curl "https://api.galaxy-hotel.net/v1/availability?from=2026-11-01&to=2026-11-04" \
-H "Authorization: Bearer gh_live_…" -H "X-Product-Key: gh_prod_…"
curl -X POST https://api.galaxy-hotel.net/v1/reservations \
-H "Authorization: Bearer gh_live_…" -H "X-Product-Key: gh_prod_…" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: be-2026-000123" \
-d '{ "external_ref": "BE-2026-000123", "status": "confirmed",
"new_party": { "first_name": "Maria", "last_name": "Rossi", "email": "maria@example.com" },
"rooms": [{ "room_type_id": 2, "arrival": "2026-11-01", "departure": "2026-11-04", "adults": 2 }] }'Die Regeln in Kürze
- Zwei Schlüssel in jedem Aufruf: der des Betriebs in Authorization: Bearer (einer pro Betrieb, mit den vom Hotel akzeptierten Berechtigungen) und der Product Key Ihres Produkts in X-Product-Key.
- JSON, Datumsangaben JJJJ-MM-TT ohne den Abreisetag, Dezimalbeträge in Euro, Fehler mit einem stabilen Code und einer lesbaren Meldung.
- 600 Aufrufe pro Minute je Schlüssel. Idempotency-Key bei Schreibvorgängen, um einen Aufruf ohne doppelte Wirkung zu wiederholen; external_ref bei Reservierungen eindeutig pro Betrieb.
- Die Version steht im Pfad (/v1): Felder kommen hinzu, werden aber weder entfernt noch umbenannt.
MCP-Server für Hotels
Um einen KI-Assistenten zu verbinden, muss man kein Integrator werden: Jede Person im Hotel erstellt ihren eigenen Schlüssel im Marketplace der App (KI-Assistenten (MCP)) oder unter Mein Profil und nutzt ihn mit Claude, ChatGPT, Cursor, n8n oder einem eigenen Agenten. Der Server spricht MCP über Streamable HTTP: eine JSON-RPC-Nachricht pro POST.
- Der Schlüssel gh_mcp_… gehört in Authorization: Bearer. Er gehört einer Person und einem Betrieb: Der Assistent sieht nur, was diese Person in der Software sieht.
- Die Werkzeuge lesen Betrieb, Zimmer, Zimmertypen, Raten, Verfügbarkeit, Reservierungen, Gäste und Rechnungen. Ausweise, Kontaktdaten und Geburtsdaten der Gäste verlassen das System nicht.
- Mit einem Schlüssel «Lesen und Vorschläge» führen check_in, check_out, assign_room und add_charge nichts aus: Sie bereiten einen Vorschlag vor, den die Person innerhalb von 15 Minuten in der App bestätigt oder verwirft.
- Er ist von der API /v1 getrennt: Die Schlüssel des einen gelten nicht beim anderen, 120 Aufrufe pro Minute und Schlüssel, und in der Testumgebung gibt es keinen MCP-Server.
claude mcp add --transport http galaxy https://api.galaxy-hotel.net/mcp \
--header "Authorization: Bearer gh_mcp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
curl -X POST https://api.galaxy-hotel.net/mcp \
-H "Authorization: Bearer gh_mcp_…" -H "Content-Type: application/json" \
-d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": { "name": "search_reservations", "arguments": { "status": "checked_in" } } }'Testumgebung
Eine gemeinsam genutzte Umgebung mit Beispieldaten, die jede Nacht um 04:00 Uhr (italienische Zeit) zurückgesetzt wird. Den Testschlüssel erstellen Sie im Integratoren-Portal, einen pro Produkt, mit allen Berechtigungen: Was Sie schreiben, sehen auch die anderen Integratoren, und es verschwindet bei der Zurücksetzung, zusammen mit den abonnierten Webhooks.
Brauchen Sie Hilfe?
Schreiben Sie an support@galaxy-hotel.net und nennen Sie den Vorgang, den Fehlercode und die Uhrzeit des Aufrufs: Die Aufrufe werden pro Schlüssel protokolliert.
Integrator werden
Für die Nutzung der API mit Hotels ist ein genehmigtes Produkt erforderlich. Sagen Sie uns, wer Sie sind und was Sie anbinden möchten: Nach der Genehmigung erhalten Sie den Zugang zum Integratoren-Portal, mit dem Product Key, der Testumgebung und der Anleitung.
Changelog
- November 2026 · MCP-Server für Integratoren (/integrator/mcp): Jede Person im Integratorenportal erstellt ihren eigenen Schlüssel (KI-Assistent (MCP)) und verbindet Claude Code, Cursor oder Codex mit dem Leitfaden und der Referenz der API, ihren Produkten samt Prüfungen vor der Freigabe, den verbundenen Unterkünften und den Webhook-Zustellungen; mit «leichten Aktionen» auch der Produktsteckbrief und der Sandbox-Schlüssel.
- November 2026 · MCP-Server für Hotels (/mcp): ein Schlüssel pro Person, Lesen und Vorschläge mit Bestätigung in der App, um Claude, ChatGPT oder einen anderen Assistenten mit den Daten eines Betriebs zu verbinden.
- Oktober 2026 · Integratoren: Anfrage über die Website, Portal mit Product Key und Testschlüssel, Produktblatt im Marketplace der Hotels, Schlüssel der Betriebe zum Abholen (GET /v1/connections); Aufrufe für ein Produkt enthalten zusätzlich den Header X-Product-Key.
- September 2026 · Erste Version: Betrieb, Verfügbarkeit, Angebote, Reservierungen, Gäste, Konten, Ereignisse und Webhooks.