Galaxy HotelCloud
API pública, webhooks y entorno de pruebas

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.

Documento OpenAPI

GET /v1/availability200 OK{ "date": "2026-11-01", "room_type_id": 2, "free": 4}POST /v1/reservations 201X-Product-Key gh_prod_…reservation.createdPOST /webhooks · 200

Cómo empezar

  1. 1

    Haz la solicitud

    Rellena el formulario al final de la página con tu empresa y el producto que quieres conectar: revisamos la solicitud y te abrimos el portal de integradores.

  2. 2

    Prueba en el entorno de pruebas

    En el portal generas la product key de tu producto y la clave del entorno de pruebas. GET /v1/me con las dos claves responde con el establecimiento y los permisos; desde ahí tipos de habitación, tarifas, disponibilidad y reservas.

  3. 3

    Pasa a producción

    Rellenas la ficha del producto (textos, logo, permisos solicitados) y la envías a revisión. Una vez aprobada, el producto entra en el Marketplace de los hoteles: cada uno lo activa aceptando los permisos y tú recoges la clave del establecimiento desde el portal o con la API, sin copiar y pegar. La ficha aparece también en el Marketplace del sitio web.

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. Para channel managers y motores de reservas, precios por número de huéspedes, cierre de ventas y estancia mínima día a día, con un evento cuando cambian. Para el escaparate fotos, logo, descripciones en varios idiomas, servicios y superficie de los tipos; en el presupuesto la tasa turística, las condiciones de cancelación, el régimen y el anticipo que pide la tarifa.

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. Para los channel managers, las reservas de los portales: nunca rechazadas por un tipo lleno, también modificadas o anuladas, y lo que el PMS no resuelve solo pasa a la recepción.

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.

Pagos

Métodos de pago del establecimiento, cuánto se ha pagado en una reserva y el registro de un pago cobrado en otro sistema, en la precuenta como un anticipo; o un enlace de pago del proveedor de tarjetas del hotel para el anticipo, el saldo o la garantía; con un permiso aparte, cargos y reembolsos en la tarjeta guardada.

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

Las reglas en breve

  • Dos claves en cada llamada: la del establecimiento en Authorization: Bearer (una por establecimiento, con los permisos que el hotel ha aceptado) y la product key de tu producto en X-Product-Key.
  • 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.

Servidor MCP para hoteles

Para conectar un asistente de IA no hace falta ser integrador: cada persona del hotel crea su clave en el Marketplace dentro de la app (Asistentes IA (MCP)) o en Mi perfil y la usa con Claude, ChatGPT, Cursor, n8n o un agente propio. El servidor habla MCP con streamable HTTP: un mensaje JSON-RPC por POST.

  • La clave gh_mcp_… va en Authorization: Bearer. Es de una persona y de un establecimiento: el asistente ve solo lo que esa persona ve en el programa de gestión.
  • Las herramientas leen establecimiento, habitaciones, tipologías, tarifas, disponibilidad, reservas, huéspedes y cuentas. Los documentos, datos de contacto y fechas de nacimiento de los huéspedes no salen.
  • Con una clave «Lectura y propuestas», check_in, check_out, assign_room y add_charge no ejecutan nada: preparan una propuesta que la persona confirma o anula en la app en 15 minutos.
  • Está separado de la API /v1: las claves de una no valen en la otra, 120 llamadas por minuto por clave, y en el entorno de pruebas no hay servidor 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" } } }'

Entorno de pruebas

Un entorno compartido con datos de ejemplo, reiniciado cada noche a las 04:00 (hora italiana). La clave de pruebas se crea desde el portal de integradores, una por producto, y tiene todos los permisos: lo que escribes lo ven también los demás integradores y desaparece al reiniciarse, junto con los webhooks suscritos.

¿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.

Hazte integrador

Para usar la API con los hoteles hace falta un producto aprobado. Dinos quién eres y qué quieres conectar: tras la aprobación recibes el acceso al portal de integradores, con la product key, el entorno de pruebas y la guía.

Lee las condiciones de uso de la API

Solicitud de integración

¿Ya tienes acceso? Entra en el portal de integradores

Registro de cambios

  • Noviembre de 2026 · Servidor MCP para integradores (/integrator/mcp): cada persona del portal de integradores crea su clave (Asistente de IA (MCP)) y conecta Claude Code, Cursor o Codex a la guía y la referencia de la API, a sus productos con los controles previos a la revisión, a los establecimientos conectados y a las entregas de los webhooks; con «acciones ligeras» también la ficha del producto y la clave de pruebas.
  • Noviembre de 2026 · Servidor MCP para hoteles (/mcp): una clave por persona, lectura y propuestas que se confirman en la app, para conectar Claude, ChatGPT u otro asistente a los datos de un establecimiento.
  • Octubre de 2026 · Integradores: solicitud desde el sitio web, portal con product key y clave de pruebas, ficha del producto en el Marketplace de los hoteles, claves de los establecimientos por recoger (GET /v1/connections); las llamadas hechas para un producto llevan también la cabecera X-Product-Key.
  • Septiembre de 2026 · Primera versión: establecimiento, disponibilidad, presupuestos, reservas, huéspedes, cuentas, eventos y webhooks.