Risposte di errore
L’API Hotspot produce due tipi di risultato: un errore di autenticazione (HTTP 401) e una risposta riuscita (HTTP 200). Un elenco di ospiti vuoto non è un errore. Di seguito trovi le situazioni che potresti incontrare e cosa fare in ciascun caso.
Codici di stato HTTP#
| Codice | Corpo | Significato e cosa fare |
|---|---|---|
200 | {"success": 1, "otelde": [...]} | Successo. Elabora l’elenco. |
200 | {"success": 1, "otelde": []} | Successo; non ci sono ospiti in hotel. Vedi più avanti la nota sugli elenchi vuoti. |
401 | {"success": 0} | Header ApiKey mancante o chiave non riconosciuta. Non riprovare; controlla la chiave e avvisa l’amministratore. |
404 | Pagina di errore | Percorso errato. Verifica che il percorso sia esattamente /public/json/customer/inhotel. |
405 | Pagina di errore | È stato usato un metodo diverso da POST (ad es. GET da un browser). |
5xx / timeout | — | Errore temporaneo del server o di rete. Riprova con attese crescenti (30 s, 1 min, 5 min) e nel frattempo continua a usare l’ultimo elenco ricevuto correttamente. |
Elenco vuoto#
otelde: [] significa che in hotel non ci sono ospiti con check-in effettuato, cosa normale per i piccoli hotel in bassa stagione. Tuttavia, un elenco che era pieno alla richiesta precedente e all’improvviso è vuoto indica di solito un errore operativo sul lato hotel (un check-out massivo errato, un cambio di stato delle prenotazioni). Prima di chiudere tutti gli account Wi-Fi, verifica che l’elenco sia risultato vuoto in due richieste consecutive.
Nuovi tentativi e timeout#
- Usa un timeout di 10 secondi per la richiesta: anche per gli hotel più grandi l’elenco arriva entro questo tempo.
- Riprova in caso di
5xxe di errori di rete; non riprovare in caso di401,404o405, che sono errori di configurazione. - Finché una richiesta non va a buon fine, conserva l’ultimo elenco ricevuto correttamente. Chiudi solo gli account degli ospiti usciti dall’elenco in una risposta riuscita.
- Conta gli errori consecutivi e avvisa l’amministratore oltre una certa soglia (ad es. 15 minuti).
Situazioni frequenti#
| Situazione | Causa probabile | Cosa fare |
|---|---|---|
| Ospite non presente nell’elenco | La reception non ha effettuato il check-in dell’ospite, la prenotazione è stata cancellata, l’ospite non è contrassegnato come “in hotel” oppure ha già effettuato il check-out. | Mostra nel portale “numero di camera e cognome non corrispondono” e indirizza l’ospite alla reception. Non serve ripetere subito la richiesta: l’ospite comparirà alla sincronizzazione successiva. |
| Più record per la stessa camera | Nella camera soggiorna più di un ospite; ciascuno è un record separato. | È normale. Apri un account per ogni ospite (unique). |
identityNumber vuoto | L’ospite è stato registrato senza i dati del documento. | Per la corrispondenza ripiega su cognome + data di nascita; nel record per la legge 5651 lascia vuoto il campo e collega il record a unique. |
roomName non corrisponde | L’ospite ha digitato “0104” o “Camera 104” invece di “104”; il valore è una stringa. | Normalizza entrambi i valori prima del confronto; non convertirli in numero. |
checkout nel passato ma ospite ancora in elenco | L’ospite ha prolungato il soggiorno o effettua un late check-out e la reception non l’ha ancora registrato. | Mantieni l’accesso aperto finché l’ospite è nell’elenco; aggiorna la fine della sessione quando checkout cambia. |