Desarrolladores

La API pública de Galaxy Hotel Cloud: conecta tu motor de reservas, channel manager, TPV o sistema de cerraduras a un establecimiento en pocos pasos.

Referencia de la API Documento OpenAPI

Cómo empezar

1
Pide una clave al hotel
El hotelero la crea en Configuración → Marketplace → «API pública y webhooks», elige qué puede hacer (solo lectura, reservas, cuentas…) y te la entrega. La clave vale para un establecimiento.
2
Prueba la clave
Llama a GET /v1/me: responde con el establecimiento y los permisos de la clave. Desde ahí, tipos de habitación, habitaciones, tarifas y disponibilidad.
3
Reserva y escucha
Crea reservas con tu propia referencia (external_ref), carga en la cuenta, coloca a los huéspedes en las habitaciones y sigue lo que ocurre con el registro de eventos.

Qué puedes hacer

Disponibilidad y precios

Habitaciones libres por tipo y noche, planes de tarifas y presupuestos calculados por el motor de precios del PMS.

Reservas

Crear, modificar, confirmar, anular; asignar habitaciones; check-in y check-out; huéspedes en la habitación con los datos que piden las autoridades.

Cuentas

Leer las cuentas de una reserva y cargar artículos: lo que hace un TPV cuando el huésped firma la cuenta a la habitación.

Eventos y webhooks

Reservas creadas, check-ins, check-outs y anulaciones en orden, leídos con un cursor o recibidos en tu dirección con webhooks firmados.

La primera llamada

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

Las reglas en breve

Clave en la cabecera Authorization: Bearer; una clave por establecimiento, con los permisos (scopes) elegidos por el hotel.
JSON, fechas AAAA-MM-DD con la salida excluida, importes decimales en euros, errores con un código estable y un mensaje legible.
600 llamadas por minuto por clave. Idempotency-Key en las escrituras para repetir una llamada sin efectos dobles; external_ref único por establecimiento en las reservas.
La versión está en la ruta (/v1): los campos se añaden, nunca se quitan ni se renombran.

Entorno de pruebas

Un entorno compartido con datos de ejemplo, reiniciado cada noche a las 04:00 (hora italiana): usa esta clave para probar las llamadas sin registrarte.

Dirección: https://api.galaxy-hotel.net/v1
Clave de prueba: gh_test_3danuvy9ll0n3joxhio85kofxwc

· La clave tiene todos los permisos y es la misma para todos: lo que escribes lo ven los demás y desaparece con el reinicio.
· Sin acceso a la aplicación y sin correos desde el sandbox; los webhooks suscritos se eliminan cada noche.
· Para un entorno propio está la prueba gratuita de 30 días: regístrate, activa la API desde el Marketplace y crea una clave.

¿Necesitas ayuda?

Escribe a support@galaxy-hotel.net con la operación, el código del error y la hora de la llamada: las llamadas quedan registradas por clave.

Registro de cambios

Septiembre de 2026 · Primera versión: establecimiento, disponibilidad, presupuestos, reservas, huéspedes, cuentas, eventos y webhooks.