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.
Como começar
- 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
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
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.
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.