Galaxy HotelCloud
Öffentliche API, Webhooks und Testumgebung

Entwickler

Die öffentliche API von Galaxy Hotel Cloud: Verbinden Sie Booking Engine, Channel Manager, POS oder Schließsystem in wenigen Schritten mit einem Betrieb.

OpenAPI-Dokument

GET /v1/availability200 OK{ "date": "2026-11-01", "room_type_id": 2, "free": 4}POST /v1/reservations 201X-Product-Key gh_prod_…reservation.createdPOST /webhooks · 200

Erste Schritte

  1. 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. 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. 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.

API-Nutzungsbedingungen lesen

Integrationsanfrage

Haben Sie bereits einen Zugang? Zum Integratoren-Portal

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.