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.
Pour commencer
- 1
Faites votre demande
Remplissez le formulaire en bas de page avec votre société et le produit que vous souhaitez connecter : nous examinons la demande et vous ouvrons le portail intégrateurs.
- 2
Essayez sur l'environnement de test
Dans le portail, vous générez la product key de votre produit et la clé de l'environnement de test. GET /v1/me avec les deux clés répond avec l'établissement et les permissions ; de là, types de chambre, tarifs, disponibilités, réservations.
- 3
Passez en production
Vous remplissez la fiche du produit (textes, logo, permissions demandées) et l'envoyez en révision. Une fois approuvée, le produit entre dans le Marketplace des hôtels : chacun l'active en acceptant les permissions et vous récupérez la clé de l'établissement depuis le portail ou avec l'API, sans copier-coller. La fiche apparaît aussi dans le Marketplace du site.
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. Pour les channel managers et les moteurs de réservation, prix par nombre de clients, arrêt des ventes et séjour minimum jour par jour, avec un événement quand ils changent. Pour la vitrine photos, logo, descriptions en plusieurs langues, services et surface des types ; dans le devis la taxe de séjour, les conditions d'annulation, la formule et l'acompte demandés par le tarif.
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. Pour les channel managers, les réservations des portails : jamais refusées pour un type complet, aussi modifiées ou annulées, et ce que le PMS ne règle pas seul va à la réception.
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.
Paiements
Moyens de paiement de l'établissement, ce qui a été payé sur une réservation et l'enregistrement d'un paiement encaissé ailleurs, sur le pré-compte comme un acompte ; ou un lien de paiement du prestataire de cartes de l'hôtel pour l'acompte, le solde ou la garantie ; avec une autorisation à part, débits et remboursements sur la carte enregistrée.
É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" \
-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 }] }'Les règles en bref
- Deux clés dans chaque appel : celle de l'établissement dans Authorization: Bearer (une par établissement, avec les permissions que l'hôtel a acceptées) et la product key de votre produit dans X-Product-Key.
- 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.
Serveur MCP pour les hôtels
Pas besoin de devenir intégrateur pour connecter un assistant IA : chaque personne de l'hôtel crée sa clé dans le Marketplace de l'application (Assistants IA (MCP)) ou dans Mon profil et l'utilise avec Claude, ChatGPT, Cursor, n8n ou son propre agent. Le serveur parle MCP en streamable HTTP : un message JSON-RPC par POST.
- La clé gh_mcp_… se met dans Authorization: Bearer. Elle appartient à une personne et à un établissement : l'assistant ne voit que ce que cette personne voit dans le logiciel.
- Les outils lisent l'établissement, les chambres, les types de chambre, les tarifs, les disponibilités, les réservations, les clients et les notes. Les pièces d'identité, coordonnées et dates de naissance des clients ne sortent pas.
- Avec une clé «Lecture et propositions», check_in, check_out, assign_room et add_charge n'exécutent rien : ils préparent une proposition que la personne confirme ou annule dans l'application sous 15 minutes.
- Il est séparé de l'API /v1 : les clés de l'un ne valent pas pour l'autre, 120 appels par minute et par clé, et l'environnement de test n'a pas de serveur MCP.
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" } } }'Environnement de test
Un environnement partagé avec des données d'exemple, réinitialisé chaque nuit à 04:00 (heure italienne). La clé de test se crée depuis le portail intégrateurs, une par produit, avec toutes les permissions : ce que vous écrivez est visible par les autres intégrateurs et disparaît à la réinitialisation, avec les webhooks souscrits.
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é.
Devenir intégrateur
Pour utiliser l'API avec les hôtels, il faut un produit approuvé. Dites-nous qui vous êtes et ce que vous souhaitez connecter : après l'approbation, vous recevez l'accès au portail intégrateurs, avec la product key, l'environnement de test et le guide.
Journal des modifications
- Novembre 2026 · Serveur MCP pour les intégrateurs (/integrator/mcp) : chaque personne du portail intégrateurs crée sa clé (Assistant IA (MCP)) et relie Claude Code, Cursor ou Codex au guide et à la référence de l'API, à ses produits avec les contrôles avant la revue, aux établissements connectés et aux livraisons des webhooks ; avec «actions légères» aussi la fiche du produit et la clé de test.
- Novembre 2026 · Serveur MCP pour les hôtels (/mcp) : une clé par personne, lecture et propositions confirmées dans l'application, pour connecter Claude, ChatGPT ou un autre assistant aux données d'un établissement.
- Octobre 2026 · Intégrateurs : demande depuis le site, portail avec product key et clé de test, fiche du produit dans le Marketplace des hôtels, clés des établissements à récupérer (GET /v1/connections) ; les appels faits pour un produit portent aussi l'en-tête X-Product-Key.
- Septembre 2026 · Première version : établissement, disponibilités, devis, réservations, clients, notes, événements et webhooks.