Respostas de erro

A API Hotspot produz dois tipos de resultado: uma falha de autenticação (HTTP 401) e uma resposta de sucesso (HTTP 200). Uma lista de hóspedes vazia não é um erro. Abaixo estão as situações que você pode encontrar e o que fazer em cada uma.

Códigos de status HTTP#

CódigoCorpoSignificado e o que fazer
200{"success": 1, "otelde": [...]}Sucesso. Processe a lista.
200{"success": 1, "otelde": []}Sucesso; não há ninguém no hotel. Veja abaixo a observação sobre listas vazias.
401{"success": 0}Cabeçalho ApiKey ausente ou chave não reconhecida. Não repita a requisição; verifique a chave e avise o administrador.
404Página de erroCaminho incorreto. Confirme que o caminho é exatamente /public/json/customer/inhotel.
405Página de erroFoi usado um método diferente de POST (ex.: GET pelo navegador).
5xx / timeout—Erro temporário de servidor ou de rede. Tente novamente com intervalos crescentes (30 s, 1 min, 5 min) e, enquanto isso, continue usando a última lista obtida com sucesso.

Lista vazia#

otelde: [] significa que não há hóspedes com check-in feito no hotel, o que é normal em hotéis pequenos fora da temporada. No entanto, uma lista que estava cheia na consulta anterior e de repente vem vazia geralmente indica um erro operacional do lado do hotel (um check-out em massa por engano, uma mudança de status de reserva). Antes de encerrar todas as contas de Wi-Fi, confirme que a lista veio vazia em duas consultas consecutivas.

Novas tentativas e timeouts#

  • Use um timeout de 10 segundos na requisição; mesmo em hotéis grandes, a lista retorna dentro desse prazo.
  • Tente novamente em caso de 5xx e erros de rede; não repita 401, 404 nem 405, que são erros de configuração.
  • Mantenha a última lista obtida com sucesso enquanto uma consulta estiver falhando. Encerre contas apenas dos hóspedes que saíram da lista em uma resposta bem-sucedida.
  • Conte as falhas consecutivas e avise o administrador quando passarem de um limite (ex.: 15 minutos).

Situações comuns#

SituaçãoCausa provávelO que fazer
Hóspede não aparece na listaA recepção ainda não fez o check-in do hóspede, a reserva foi cancelada, o hóspede não está marcado como “no hotel” ou já fez check-out.Mostre “número do quarto e sobrenome não conferem” no portal e oriente o hóspede a procurar a recepção. Não é preciso buscar a lista de novo; o hóspede aparece na próxima sincronização.
Vários registros para o mesmo quartoHá mais de um hóspede no quarto; cada um é um registro separado.Normal. Abra as contas por hóspede (unique).
identityNumber vazioO hóspede foi registrado sem dados de identificação.Use sobrenome + data de nascimento na correspondência; deixe o campo vazio no registro da Lei 5651 e vincule-o ao unique.
roomName não confereO hóspede digitou “0104” ou “Quarto 104” em vez de “104”; o valor é uma string.Normalize os dois lados antes de comparar; não converta para número.
checkout no passado, mas o hóspede continua na listaO hóspede estendeu a estadia ou vai fazer check-out mais tarde, e a recepção ainda não registrou isso.Mantenha o acesso liberado enquanto o hóspede estiver na lista; atualize o fim da sessão quando checkout mudar.
Última atualização: 21 de setembro de 2026Encontrou um erro? Avise-nos