Hóspedes no hotel

O único recurso da integração de hotspot. Retorna quarto, identidade e dados de check-in/check-out de todos os hóspedes que estão no hotel neste momento (com check-in feito e sem check-out). O software de hotspot busca essa lista em intervalos regulares e abre ou fecha as contas de Wi-Fi de acordo com ela; as etapas estão descritas no guia Fluxo de verificação de hóspedes.

POST/public/json/customer/inhotelLista de hóspedes no hotel

Objeto#

Campos

uniqueinteger
ID do registro de hospedagem, único por hóspede e reserva. Use-o como chave de usuário / sessão no lado do hotspot.
rezervasyon_idinteger
ID da reserva. Hóspedes que dividem o mesmo quarto compartilham este valor.
inHotelinteger
1 = o hóspede está no hotel. Sempre 1, pois o endpoint retorna apenas hóspedes no hotel.
firstNamestring
Nome. Geralmente em maiúsculas, conforme lido no documento de identidade; vários prenomes são separados por espaço.
lastNamestring
Sobrenome. Geralmente em maiúsculas.
identityNumberstring | null
Número de identidade nacional turco ou número do passaporte, como impresso no documento. Pode estar vazio para hóspedes registrados sem dados de identificação.
birthDatestring | null
Data de nascimento, DD.MM.YYYY. Pode estar vazia.
roomIDinteger
ID do quarto no HMS.
roomNamestring
Nome / número do quarto como o hóspede o vê na porta e no cartão-chave. Peça este valor como “número do quarto” no portal.
checkininteger
Horário de check-in do hóspede como timestamp Unix (segundos).
checkoutinteger
Data prevista de check-out como timestamp Unix do início do dia (00:00 UTC); não inclui horário. Some o horário de check-out do hotel (geralmente 12:00) para obter o fim da sessão.
checkout2integer | null
Horário efetivo de check-out. null para hóspedes no hotel; quem faz check-out sai da lista de qualquer forma.
mikrotikSifrelemeinteger
Configuração de criptografia Mikrotik do prédio do quarto no HMS: 0 nome do quarto (a senha do Wi-Fi é o número do quarto), 1 sem senha. Aplique a mesma política no seu próprio portal.
01
Objeto de exemplo
{
    "mikrotikSifreleme": 0,
    "unique": 58211,
    "inHotel": 1,
    "identityNumber": "11111111110",
    "firstName": "AYŞE",
    "lastName": "DEMİR",
    "birthDate": "14.03.1985",
    "roomID": 4,
    "roomName": "104",
    "checkin": 1788863400,
    "checkout": 1788998400,
    "checkout2": null,
    "rezervasyon_id": 282799
}

Lista de hóspedes no hotel#

POST/public/json/customer/inhotel

Autenticação: Cabeçalho ApiKey

Retorna a lista completa de hóspedes no hotel. Não há parâmetros de filtro nem corpo de requisição. Um hóspede aparece na lista quando a reserva está ativa, teve check-in feito e ainda não teve check-out, e o hóspede está marcado como “no hotel”. Cada hóspede da mesma reserva é um registro separado.

A resposta não é paginada; hotéis grandes podem retornar várias centenas de registros. Guarde a lista em cache e atualize-a no intervalo recomendado.

Cabeçalhos

ApiKeystringobrigatório
Chave de API personalizada gerada no painel administrativo do HMS. Fica vinculada a um único hotel, e é isso que define quais hóspedes são listados.
HotelCodeinteger
ID do hotel no HMS. Não é usado na validação, já que o servidor identifica o hotel pela chave; é recomendado enviá-lo para fins de log e compatibilidade.

Resposta

200 success: 1 e o array otelde. Se não houver ninguém no hotel, o array vem vazio; isso não é um erro.

successinteger
1 sucesso, 0 falha. É um número, não um booleano como no Online Booking.
otelde[]object[]
Registros de hóspedes. Veja a seção Objeto acima para os campos.

Respostas de erro

  • 401 Cabeçalho ApiKey ausente, vazio ou não definido no HMS (a chave pode ter sido excluída). Corpo: {"success": 0}.
  • 405 A requisição usou um método diferente de POST (por exemplo, GET pela barra de endereços do navegador).
Requisição
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
  -H "ApiKey: $HMS_API_KEY" \
  -H "HotelCode: 1000"
Resposta · 200
{
    "success": 1,
    "otelde": [
        {
            "mikrotikSifreleme": 0,
            "unique": 58211,
            "inHotel": 1,
            "identityNumber": "11111111110",
            "firstName": "AYŞE",
            "lastName": "DEMİR",
            "birthDate": "14.03.1985",
            "roomID": 4,
            "roomName": "104",
            "checkin": 1788863400,
            "checkout": 1788998400,
            "checkout2": null,
            "rezervasyon_id": 282799
        },
        {
            "mikrotikSifreleme": 0,
            "unique": 58212,
            "inHotel": 1,
            "identityNumber": "22222222220",
            "firstName": "MEHMET",
            "lastName": "DEMİR",
            "birthDate": "02.11.1982",
            "roomID": 4,
            "roomName": "104",
            "checkin": 1788863400,
            "checkout": 1788998400,
            "checkout2": null,
            "rezervasyon_id": 282799
        },
        {
            "mikrotikSifreleme": 0,
            "unique": 58197,
            "inHotel": 1,
            "identityNumber": "U01234567",
            "firstName": "JULIA",
            "lastName": "WAGNER",
            "birthDate": "27.06.1990",
            "roomID": 12,
            "roomName": "205",
            "checkin": 1788782700,
            "checkout": 1789084800,
            "checkout2": null,
            "rezervasyon_id": 282803
        }
    ]
}
Resposta · 200 (nenhum hóspede no hotel)
{
    "success": 1,
    "otelde": []
}
Resposta · 401 (chave inválida)
{
    "success": 0
}
Última atualização: 21 de setembro de 2026Encontrou um erro? Avise-nos