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.

Referência da API Documento OpenAPI

Como começar

1
Peça uma chave ao hotel
O hoteleiro cria-a em Definições → Marketplace → «API pública e webhooks», escolhe o que ela pode fazer (apenas leitura, reservas, contas…) e entrega-lha. A chave é válida para um estabelecimento.
2
Teste a chave
Chame GET /v1/me: responde com o estabelecimento e as permissões da chave. A partir daí, tipologias, quartos, tarifas e disponibilidade.
3
Reserve e escute
Crie reservas com a sua própria referência (external_ref), debite na conta, coloque os hóspedes nos quartos e acompanhe o que acontece com o registo de eventos.

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.

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.

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.

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"

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

As regras em resumo

Chave no cabeçalho Authorization: Bearer; uma chave por estabelecimento, com as permissões (scopes) escolhidas pelo hotel.
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.

Ambiente de testes

Um ambiente partilhado com dados de exemplo, reiniciado todas as noites às 04:00 (hora italiana): utilize esta chave para testar as chamadas sem se registar.

Endereço: https://api.galaxy-hotel.net/v1
Chave de teste: gh_test_3danuvy9ll0n3joxhio85kofxwc

· A chave tem todas as permissões e é a mesma para todos: o que escrever também é visto pelos outros e desaparece com o reinício.
· Nenhum acesso à aplicação e nenhum e-mail sai da sandbox; os webhooks subscritos são removidos todas as noites.
· Para um ambiente próprio existe o período experimental gratuito de 30 dias: registe-se, ative a API no Marketplace e crie uma chave.

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.

Registo de alterações

Setembro de 2026 · Primeira versão: estabelecimento, disponibilidade, orçamentos, reservas, hóspedes, contas, eventos e webhooks.