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
Schlüssel beim Hotel anfordern
Der Hotelier erstellt ihn unter Einstellungen → Marketplace → „Öffentliche API und Webhooks“, legt fest, was der Schlüssel darf (nur Lesen, Reservierungen, Konten…), und übergibt ihn Ihnen. Der Schlüssel gilt für einen Betrieb.
- 2
Schlüssel testen
Rufen Sie GET /v1/me auf: Die Antwort enthält den Betrieb und die Berechtigungen des Schlüssels. Von dort aus Zimmertypen, Zimmer, Raten und Verfügbarkeit.
- 3
Buchen und mithören
Erstellen Sie Reservierungen mit Ihrer eigenen Referenz (external_ref), belasten Sie das Konto, ordnen Sie die Gäste den Zimmern zu und verfolgen Sie über das Ereignisprotokoll, was geschieht.
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.
Reservierungen
Erstellen, ändern, bestätigen, stornieren; Zimmer zuweisen; Check-in und Check-out; Gäste im Zimmer mit den Daten für die Meldepflichten.
Konten
Die Konten einer Reservierung lesen und Artikel belasten: das, was ein POS tut, wenn der Gast die Rechnung aufs Zimmer schreiben lässt.
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"
{
"key": { "name": "Booking engine", "scopes": ["availability:read", "reservations:write"] },
"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-10-01&to=2026-10-04" \
-H "Authorization: Bearer gh_live_…"
curl -X POST https://api.galaxy-hotel.net/v1/reservations \
-H "Authorization: Bearer gh_live_…" -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-10-01", "departure": "2026-10-04", "adults": 2 }] }'Die Regeln in Kürze
- Schlüssel im Header Authorization: Bearer; ein Schlüssel pro Betrieb, mit den vom Hotel gewählten Berechtigungen (Scopes).
- 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.
Testumgebung
Eine gemeinsam genutzte Umgebung mit Beispieldaten, die jede Nacht um 04:00 Uhr (italienische Zeit) zurückgesetzt wird: Verwenden Sie diesen Schlüssel, um die Aufrufe ohne Registrierung auszuprobieren.
- Adresse
https://api.galaxy-hotel.net/v1- Testschlüssel
gh_test_3danuvy9ll0n3joxhio85kofxwc
- · Der Schlüssel hat alle Berechtigungen und ist für alle derselbe: Was Sie schreiben, sehen auch die anderen, und es verschwindet bei der Zurücksetzung.
- · Kein Zugang zur App, und aus der Sandbox wird keine E-Mail versendet; abonnierte Webhooks werden jede Nacht entfernt.
- · Für eine eigene Umgebung gibt es die kostenlose 30-Tage-Testphase: Registrieren Sie sich, aktivieren Sie die API im Marketplace und erstellen Sie einen Schlüssel.
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.
Changelog
- September 2026 · Erste Version: Betrieb, Verfügbarkeit, Angebote, Reservierungen, Gäste, Konten, Ereignisse und Webhooks.