Développeurs

L'API publique de Galaxy Hotel Cloud : connectez votre moteur de réservation, channel manager, caisse ou système de serrures à un établissement en quelques étapes.

Référence de l'API Document OpenAPI

Pour commencer

1
Demandez une clé à l'hôtel
L'hôtelier la crée dans Paramètres → Marketplace → « API publique et webhooks », choisit ce qu'elle peut faire (lecture seule, réservations, notes…) et vous la remet. Une clé vaut pour un établissement.
2
Essayez la clé
Appelez GET /v1/me : la réponse donne l'établissement et les autorisations de la clé. Ensuite, types de chambres, chambres, tarifs et disponibilités.
3
Réservez et écoutez
Créez des réservations avec votre propre référence (external_ref), facturez sur la note, placez les clients dans les chambres et suivez ce qui se passe grâce au journal des événements.

Ce que vous pouvez faire

Disponibilités et prix

Chambres libres par type et par nuit, plans tarifaires et devis calculés par le moteur de prix du PMS.

Réservations

Créer, modifier, confirmer, annuler ; attribuer les chambres ; check-in et check-out ; clients en chambre avec les données demandées par les autorités.

Notes

Lire les notes d'une réservation et facturer des articles : ce que fait une caisse quand le client signe l'addition sur sa chambre.

Événements et webhooks

Réservations créées, check-ins, check-outs et annulations dans l'ordre, lus avec un curseur ou reçus à votre adresse par des webhooks signés.

Le premier appel

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

Les règles en bref

Clé dans l'en-tête Authorization: Bearer ; une clé par établissement, avec les autorisations (scopes) choisies par l'hôtel.
JSON, dates AAAA-MM-JJ avec le départ exclu, montants décimaux en euros, erreurs avec un code stable et un message lisible.
600 appels par minute et par clé. Idempotency-Key sur les écritures pour répéter un appel sans double effet ; external_ref unique par établissement sur les réservations.
La version est dans le chemin (/v1) : les champs s'ajoutent, jamais retirés ni renommés.

Environnement de test

Un environnement partagé avec des données d'exemple, réinitialisé chaque nuit à 04:00 (heure italienne) : utilisez cette clé pour essayer les appels sans vous inscrire.

Adresse: https://api.galaxy-hotel.net/v1
Clé de test: gh_test_3danuvy9ll0n3joxhio85kofxwc

· La clé a toutes les autorisations et est la même pour tous : ce que vous écrivez est visible par les autres et disparaît à la réinitialisation.
· Aucun accès à l'application et aucun e-mail ne part du bac à sable ; les webhooks souscrits sont supprimés chaque nuit.
· Pour un environnement à vous, l'essai gratuit de 30 jours : inscrivez-vous, activez l'API depuis le Marketplace et créez une clé.

Besoin d'aide ?

Écrivez à support@galaxy-hotel.net avec l'opération, le code d'erreur et l'heure de l'appel : les appels sont tracés par clé.

Journal des modifications

Septembre 2026 · Première version : établissement, disponibilités, devis, réservations, clients, notes, événements et webhooks.