Sviluppatori

L'API pubblica di Galaxy Hotel Cloud: collega il tuo booking engine, channel manager, POS o sistema di serrature a una struttura in pochi passi.

Riferimento dell'API Documento OpenAPI

Come iniziare

1
Chiedi una chiave all'hotel
L'albergatore la crea in Impostazioni → Marketplace → «API pubblica e webhook», sceglie cosa può fare (solo lettura, prenotazioni, conti…) e te la consegna. La chiave vale per una struttura.
2
Prova la chiave
Chiama GET /v1/me: risponde con la struttura e i permessi della chiave. Da lì tipologie, camere, tariffe e disponibilità.
3
Prenota e ascolta
Crea prenotazioni con il tuo riferimento (external_ref), addebita sul conto, metti gli ospiti in camera e segui quello che succede con il registro degli eventi.

Cosa puoi fare

Disponibilità e prezzi

Camere libere per tipologia e notte, piani tariffari e preventivi calcolati dal motore prezzi del PMS.

Prenotazioni

Creare, modificare, confermare, annullare; assegnare le camere; check-in e check-out; ospiti in camera con i dati per gli adempimenti.

Conti

Leggere i conti di una prenotazione e addebitare articoli: ciò che fa un POS quando l'ospite firma il conto in camera.

Eventi e webhook

Prenotazioni create, check-in, check-out e annulli in ordine, da leggere a cursore oppure ricevuti sul tuo indirizzo con i webhook firmati.

La prima chiamata

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 }] }'

Le regole in breve

Chiave nell'intestazione Authorization: Bearer; una chiave per struttura, con i permessi (scope) scelti dall'hotel.
JSON, date AAAA-MM-GG con partenza esclusa, importi decimali in euro, errori con un codice stabile e un messaggio leggibile.
600 chiamate al minuto per chiave. Idempotency-Key sulle scritture per ripetere una chiamata senza effetti doppi; external_ref unico per struttura sulle prenotazioni.
La versione è nel percorso (/v1): i campi si aggiungono, non si tolgono né si rinominano.

Ambiente di prova

Un ambiente condiviso con dati di esempio, azzerato ogni notte alle 04:00 (ora italiana): usa questa chiave per provare le chiamate senza registrarti.

Indirizzo: https://api.galaxy-hotel.net/v1
Chiave di prova: gh_test_3danuvy9ll0n3joxhio85kofxwc

· La chiave ha tutti i permessi ed è la stessa per tutti: quello che scrivi lo vedono anche gli altri e sparisce all'azzeramento.
· Nessun accesso all'app e nessuna e-mail parte dalla sandbox; i webhook sottoscritti vengono rimossi ogni notte.
· Per un ambiente tuo c'è la prova gratuita di 30 giorni: registrati, attiva l'API dal Marketplace e crea una chiave.

Serve aiuto?

Scrivi a support@galaxy-hotel.net con l'operazione, il codice dell'errore e l'ora della chiamata: le chiamate sono tracciate per chiave.

Changelog

Settembre 2026 · Prima versione: struttura, disponibilità, preventivi, prenotazioni, ospiti, conti, eventi e webhook.