Răspunsuri de eroare
API-ul Hotspot produce două tipuri de rezultat: o autentificare eșuată (HTTP 401) și un răspuns reușit (HTTP 200). O listă de oaspeți goală nu este o eroare. Mai jos găsiți situațiile pe care le puteți întâlni și ce trebuie făcut în fiecare caz.
Coduri de stare HTTP#
| Cod | Corp | Semnificație și ce trebuie făcut |
|---|---|---|
200 | {"success": 1, "otelde": [...]} | Succes. Procesați lista. |
200 | {"success": 1, "otelde": []} | Succes; nu este cazat nimeni. Consultați mai jos observația despre listele goale. |
401 | {"success": 0} | Antetul ApiKey lipsește sau cheia nu este recunoscută. Nu reîncercați; verificați cheia și anunțați administratorul. |
404 | Pagină de eroare | Cale greșită. Verificați dacă ruta este exact /public/json/customer/inhotel. |
405 | Pagină de eroare | S-a folosit altă metodă decât POST (de ex. GET dintr-un browser). |
5xx / timeout | — | Eroare temporară de server sau de rețea. Reîncercați la intervale crescătoare (30 s, 1 min, 5 min) și, între timp, continuați să folosiți ultima listă obținută cu succes. |
Listă goală#
otelde: [] înseamnă că nu există oaspeți cazați cu check-in făcut, lucru normal pentru hotelurile mici în extrasezon. Totuși, o listă care la interogarea anterioară era plină și devine brusc goală indică de obicei o greșeală operațională la hotel (un check-out în masă făcut din greșeală, o schimbare a stării rezervării). Înainte de a închide toate conturile Wi-Fi, confirmați că lista a venit goală la două interogări consecutive.
Reîncercări și timeouturi#
- Folosiți un timeout de 10 secunde pentru cerere; chiar și la hotelurile mari, lista este returnată în acest interval.
- Reîncercați la
5xxși la erori de rețea; nu reîncercați401,404sau405, care sunt erori de configurare. - Păstrați ultima listă obținută cu succes cât timp o interogare eșuează. Închideți conturi doar pentru oaspeții care au dispărut din listă într-un răspuns reușit.
- Numărați eșecurile consecutive și anunțați administratorul după depășirea unui prag (de ex. 15 minute).
Situații frecvente#
| Situație | Cauză probabilă | Ce trebuie făcut |
|---|---|---|
| Oaspetele nu apare în listă | Recepția nu a făcut check-in-ul oaspetelui, rezervarea a fost anulată, oaspetele nu este marcat „cazat” sau a făcut deja check-out. | Afișați pe portal „numărul camerei și numele de familie nu corespund” și îndrumați oaspetele către recepție. Nu este nevoie să reîncărcați lista; oaspetele apare la următoarea sincronizare. |
| Mai multe înregistrări pentru aceeași cameră | În cameră stau mai mulți oaspeți; fiecare este o înregistrare separată. | Normal. Deschideți conturi per oaspete (unique). |
identityNumber gol | Oaspetele a fost înregistrat fără datele actului de identitate. | Folosiți ca alternativă potrivirea după numele de familie + data nașterii; lăsați câmpul gol în înregistrarea pentru Legea nr. 5651 și asociați-o cu unique. |
roomName nu corespunde | Oaspetele a tastat „0104” sau „Camera 104” în loc de „104”; valoarea este un șir. | Normalizați ambele părți înainte de comparare; nu convertiți la număr. |
checkout în trecut, dar oaspetele este încă în listă | Oaspetele și-a prelungit sejurul sau face check-out târziu, iar recepția nu a procesat încă acest lucru. | Păstrați accesul deschis cât timp oaspetele este în listă; actualizați sfârșitul sesiunii când se schimbă checkout. |