Galaxy HotelCloud
API pública, webhooks e ambiente de testes

Programadores

A API pública do Galaxy Hotel Cloud: ligue o seu motor de reservas, channel manager, POS ou sistema de fechaduras a um estabelecimento em poucos passos.

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

Como começar

  1. 1

    Faça o pedido

    Preencha o formulário no fim da página com a sua empresa e o produto que pretende ligar: analisamos o pedido e abrimos-lhe o portal de integradores.

  2. 2

    Experimente no ambiente de testes

    No portal gera a product key do seu produto e a chave do ambiente de testes. GET /v1/me com as duas chaves responde com o estabelecimento e as permissões; a partir daí, tipologias, tarifas, disponibilidade e reservas.

  3. 3

    Passe para produção

    Preenche a ficha do produto (textos, logótipo, permissões pedidas) e envia-a para revisão. Depois de aprovada, o produto entra no Marketplace dos hotéis: cada um ativa-o aceitando as permissões e você recolhe a chave do estabelecimento no portal ou com a API, sem copiar e colar. A ficha aparece também no Marketplace do site.

O que pode fazer

Disponibilidade e preços

Quartos livres por tipologia e noite, planos tarifários e orçamentos calculados pelo motor de preços do PMS. Para channel managers e motores de reservas, preços por número de hóspedes, paragem de vendas e estadia mínima dia a dia, com um evento quando mudam. Para a montra fotos, logótipo, descrições em várias línguas, serviços e área das tipologias; no orçamento a taxa turística, as condições de cancelamento, o regime e o sinal pedidos pela tarifa.

Reservas

Criar, alterar, confirmar, anular; atribuir os quartos; check-in e check-out; hóspedes no quarto com os dados para as obrigações legais. Para os channel managers, as reservas dos portais: nunca recusadas por uma tipologia cheia, também alteradas ou anuladas, e o que o PMS não resolve sozinho vai para a receção.

Contas

Ler as contas de uma reserva e debitar artigos: o que faz um POS quando o hóspede assina a conta para o quarto.

Pagamentos

Métodos de pagamento do estabelecimento, quanto foi pago numa reserva e o registo de um pagamento recebido noutro sistema, na pré-conta como um sinal; ou um link de pagamento do fornecedor de cartões do hotel para o sinal, o saldo ou a garantia; com uma permissão à parte, cobranças e reembolsos no cartão guardado.

Eventos e webhooks

Reservas criadas, check-ins, check-outs e anulações por ordem, para ler com cursor ou recebidos no seu endereço com webhooks assinados.

A primeira chamada

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

As regras em resumo

  • Duas chaves em cada chamada: a do estabelecimento em Authorization: Bearer (uma por estabelecimento, com as permissões que o hotel aceitou) e a product key do seu produto em X-Product-Key.
  • JSON, datas AAAA-MM-DD com a partida excluída, montantes decimais em euros, erros com um código estável e uma mensagem legível.
  • 600 chamadas por minuto por chave. Idempotency-Key nas escritas para repetir uma chamada sem efeitos duplicados; external_ref único por estabelecimento nas reservas.
  • A versão está no caminho (/v1): os campos são acrescentados, nunca removidos nem renomeados.

Servidor MCP para hotéis

Para ligar um assistente de IA não é preciso ser integrador: cada pessoa do hotel cria a sua chave no Marketplace dentro da app (Assistentes IA (MCP)) ou em O meu perfil e usa-a com o Claude, o ChatGPT, o Cursor, o n8n ou um agente próprio. O servidor fala MCP com streamable HTTP: uma mensagem JSON-RPC por POST.

  • A chave gh_mcp_… vai em Authorization: Bearer. É de uma pessoa e de um alojamento: o assistente vê só o que essa pessoa vê no programa de gestão.
  • As ferramentas leem alojamento, quartos, tipologias, tarifários, disponibilidade, reservas, hóspedes e contas. Os documentos, contactos e datas de nascimento dos hóspedes não saem.
  • Com uma chave «Leitura e propostas», check_in, check_out, assign_room e add_charge não executam nada: preparam uma proposta que a pessoa confirma ou anula na app em 15 minutos.
  • É separado da API /v1: as chaves de uma não valem na outra, 120 chamadas por minuto por chave, e no ambiente de testes não há 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" } } }'

Ambiente de testes

Um ambiente partilhado com dados de exemplo, reiniciado todas as noites às 04:00 (hora italiana). A chave de testes é criada no portal de integradores, uma por produto, e tem todas as permissões: o que escrever é visível para os outros integradores e desaparece na reinicialização, juntamente com os webhooks subscritos.

Precisa de ajuda?

Escreva para support@galaxy-hotel.net com a operação, o código do erro e a hora da chamada: as chamadas são registadas por chave.

Torne-se integrador

Para utilizar a API com os hotéis é necessário um produto aprovado. Diga-nos quem é e o que pretende ligar: após a aprovação recebe o acesso ao portal de integradores, com a product key, o ambiente de testes e o guia.

Leia as condições de utilização da API

Pedido de integração

Já tem acesso? Entrar no portal de integradores

Registo de alterações

  • Novembro de 2026 · Servidor MCP para integradores (/integrator/mcp): cada pessoa do portal de integradores cria a sua chave (Assistente de IA (MCP)) e liga o Claude Code, o Cursor ou o Codex ao guia e à referência da API, aos seus produtos com as verificações antes da revisão, aos estabelecimentos ligados e às entregas dos webhooks; com «ações leves» também a ficha do produto e a chave de testes.
  • Novembro de 2026 · Servidor MCP para hotéis (/mcp): uma chave por pessoa, leitura e propostas confirmadas na app, para ligar o Claude, o ChatGPT ou outro assistente aos dados de um alojamento.
  • Outubro de 2026 · Integradores: pedido no site, portal com product key e chave de testes, ficha do produto no Marketplace dos hotéis, chaves dos estabelecimentos por recolher (GET /v1/connections); as chamadas feitas para um produto levam também o cabeçalho X-Product-Key.
  • Setembro de 2026 · Primeira versão: estabelecimento, disponibilidade, orçamentos, reservas, hóspedes, contas, eventos e webhooks.