Respuestas de error

La API de Hotspot produce dos tipos de resultado: un error de autenticación (HTTP 401) y una respuesta correcta (HTTP 200). Una lista de huéspedes vacía no es un error. A continuación se describen las situaciones que te puedes encontrar y qué hacer en cada una.

Códigos de estado HTTP#

CódigoCuerpoSignificado y qué hacer
200{"success": 1, "otelde": [...]}Éxito. Procesa la lista.
200{"success": 1, "otelde": []}Éxito; no hay nadie alojado. Consulta más abajo la nota sobre las listas vacías.
401{"success": 0}Falta el encabezado ApiKey o la clave no se reconoce. No reintentes; revisa la clave y avisa al administrador.
404Página de errorRuta incorrecta. Comprueba que la ruta sea exactamente /public/json/customer/inhotel.
405Página de errorSe usó un método distinto de POST (p. ej., GET desde un navegador).
5xx / tiempo de espera agotado—Error temporal del servidor o de la red. Reintenta con esperas crecientes (30 s, 1 min, 5 min) y, mientras tanto, sigue usando la última lista obtenida correctamente.

Lista vacía#

otelde: [] significa que no hay huéspedes con el check-in hecho alojados en el hotel, algo normal en hoteles pequeños fuera de temporada. Sin embargo, una lista que estaba llena en la consulta anterior y de repente llega vacía suele indicar un error operativo en el hotel (un check-out masivo por error, un cambio de estado de las reservas). Antes de cerrar todas las cuentas de Wi-Fi, confirma que la lista ha llegado vacía en dos consultas consecutivas.

Reintentos y tiempos de espera#

  • Usa un tiempo de espera de 10 segundos por solicitud; incluso en hoteles grandes, la lista se devuelve en ese plazo.
  • Reintenta ante errores 5xx y errores de red; no reintentes 401, 404 ni 405, que son errores de configuración.
  • Mientras una consulta falle, conserva la última lista obtenida correctamente. Cierra cuentas solo de los huéspedes que desaparecen de la lista en una respuesta correcta.
  • Cuenta los fallos consecutivos y avisa al administrador cuando se supere un umbral (p. ej., 15 minutos).

Situaciones habituales#

SituaciónCausa probableQué hacer
El huésped no está en la listaLa recepción no ha hecho el check-in del huésped, la reserva se ha cancelado, el huésped no está marcado como “alojado” o ya ha hecho el check-out.Muestra en el portal “el número de habitación y el apellido no coinciden” y remite al huésped a la recepción. No hace falta volver a pedir la lista; el huésped aparecerá en la siguiente sincronización.
Varios registros para la misma habitaciónHay más de un huésped alojado en la habitación; cada uno es un registro independiente.Es normal. Abre las cuentas por huésped (unique).
identityNumber vacíoEl huésped se registró sin datos de identidad.Para la coincidencia, recurre a apellido + fecha de nacimiento; deja el campo vacío en el registro de la Ley turca n.º 5651 y vincúlalo a unique.
roomName no coincideEl huésped escribió “0104” o “Habitación 104” en lugar de “104”; el valor es una cadena.Normaliza ambos lados antes de comparar; no lo conviertas a número.
checkout ya pasado, pero el huésped sigue en la listaEl huésped ha prolongado la estancia o sale tarde y la recepción aún no lo ha procesado.Mantén el acceso abierto mientras el huésped siga en la lista; actualiza el fin de la sesión cuando cambie checkout.
Última actualización: 21 de septiembre de 2026¿Has encontrado un error? Avísanos