Portal do desenvolvedorHMS Software Hoteleiro

Conecte seu software aos módulos do HMS

Documentação de API separada para cada módulo do software hoteleiro: motor de reservas, Wi-Fi para hóspedes, PDV de restaurante, spa, TV, PABX e serviços de IA. As APIs Online Booking e Hotspot já estão no ar; as demais virão em seguida.

Autenticação
Token Bearer ou cabeçalho ApiKey
Formato
Respostas JSON com envelope success
No ar
2 produtos · 17 endpoints
Em breve
5 produtos
Requisição
# Consulta de quartos e tarifas
curl "https://test.hms.gen.tr/external/online/roomType" \
  -H "Authorization: Bearer $HMS_TOKEN" \
  -d "hotelID=1000" -d "startDate=2026-08-18" -d "endDate=2026-08-20" \
  -d "adultCount=2"
Resposta · 200 (resumida)
{
    "success": true,
    "items": [
        {
            "id": 2,
            "name": "Quarto Standard",
            "roomCount": 5,
            "currency": "TRY",
            "accommodationTypes": [
                {
                    "id": 2,
                    "title": "Café da manhã incluído",
                    "prices": {
                        "2-1": {
                            "total": 2,
                            "price": "1930.00",
                            "nonRefundable": ""
                        },
                        "2-0": {
                            "total": 2,
                            "price": "1737.00",
                            "nonRefundable": "[NR]"
                        }
                    }
                }
            ]
        }
    ],
    "count": 1
}

Produtos

Cada produto tem sua própria documentação, referência da API e exemplos de código. Os que estão em preparação serão anunciados nas notas de versão quando forem publicados.

Princípios comuns a todos os produtos

Depois de integrar um módulo, os outros vão parecer familiares.

Chave vinculada ao hotel

No Online Booking, o par apiKey/apiSecret emitido pela HMS é trocado por um Bearer token vinculado ao hotel e válido por 7 dias. Integrações locais, como o Hotspot, usam uma chave gerada no próprio painel do hotel, enviada no cabeçalho ApiKey em cada requisição.

Autenticação

Envelope success

As respostas são JSON e trazem o indicador success. Erros de regra de negócio retornam como HTTP 200 com message ou errorCode; erros de autenticação retornam 401.

Requisições e respostas

Exemplos funcionais

Exemplos em cURL, Node.js e PHP são gerados para cada endpoint; basta copiar, adicionar sua chave e executar.

Referência da API

Alterações recentes

Todas as notas de versão

  • Site
    Suporte a 22 idiomas
    NovoNovo
  • Hotspot
    Documentação da API Hotspot publicada
    NovoNovo
  • Online Booking
    Documentação da API Online Booking publicada
    NovoNovoNovo

Precisa de ajuda?

Nossa equipe de desenvolvimento responde em até um dia útil.

Inclua o corpo da requisição (com segredos e dados de cartão mascarados), a resposta e o horário. Use o mesmo endereço para chaves de parceiro, hotéis de teste e acesso antecipado.