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
Bearerou cabeçalhoApiKey - Formato
- Respostas JSON com envelope
success - No ar
- 2 produtos · 17 endpoints
- Em breve
- 5 produtos
# 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"# Lista de hóspedes no hotel
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
-H "ApiKey: $HMS_API_KEY" \
-H "HotelCode: 1000"{
"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
}{
"success": 1,
"otelde": [
{
"unique": 58211,
"firstName": "AYŞE",
"lastName": "DEMİR",
"identityNumber": "11111111110",
"birthDate": "14.03.1985",
"roomName": "104",
"checkin": 1788863400,
"checkout": 1788998400,
"rezervasyon_id": 282799
}
]
}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.
Online Booking
API do motor de reservas
Conecta o motor de reservas do site do hotel ao HMS: lista de quartos e tarifas, disponibilidade no calendário, cupons, pagamento e envio de reservas.
Hotspot
Wi-Fi para hóspedes e registros da Lei 5651
Fornece ao sistema de hotspot a lista de hóspedes no hotel: quarto, identidade, horários de check-in e check-out. Serve para validar o login no Wi-Fi pelo número do quarto e manter os registros de acesso exigidos pela Lei turca nº 5651.
PDV de Restaurante
Comandas e lançamentos no quarto
Lançamento de comandas de restaurante, bar e café no fólio do quarto, sincronização de cardápio e estoque.
Spa
Agendamentos e serviços
Agendamentos de spa e bem-estar, catálogo de serviços e integração de lançamentos no quarto.
IA
Serviços de assistente e recomendação
Acesso a serviços de IA para o assistente do hóspede, recomendações de tarifas e relatórios.
TV
Sistemas de TV no quarto
Dados do hóspede, fólio, mensagens e solicitações de serviço para a interface de TV do quarto.
PABX
PABX e registros de chamadas
Integração com o PABX: ativação e bloqueio de ramais no check-in/out e lançamento das tarifas de ligações no fólio.
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.
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.
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 APIAlterações recentes
-
Suporte a 22 idiomasNovoNovo
-
Documentação da API Hotspot publicadaNovoNovo
-
Documentação da API Online Booking publicadaNovoNovoNovo
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.