Xəta cavabları
Hotspot API iki növ nəticə verir: uğursuz autentifikasiya (HTTP 401) və uğurlu cavab (HTTP 200). Boş qonaq siyahısı xəta deyil. Aşağıda rast gələ biləcəyiniz hallar və hər birində nə etmək lazım olduğu göstərilib.
HTTP status kodları#
| Kod | Gövdə | Mənası və nə etməli |
|---|---|---|
200 | {"success": 1, "otelde": [...]} | Uğurlu. Siyahını emal edin. |
200 | {"success": 1, "otelde": []} | Uğurlu; oteldə heç kim yoxdur. Aşağıda boş siyahılar barədə qeydə baxın. |
401 | {"success": 0} | ApiKey başlığı yoxdur və ya açar tanınmadı. Təkrar cəhd etməyin; açarı yoxlayın və administratoru xəbərdar edin. |
404 | Xəta səhifəsi | Yanlış yol. Yolun məhz /public/json/customer/inhotel olduğunu yoxlayın. |
405 | Xəta səhifəsi | POST deyil, başqa metod istifadə olunub (məs. brauzerdən GET). |
5xx / vaxt aşımı | — | Müvəqqəti server və ya şəbəkə xətası. Artan fasilələrlə (30 san, 1 dəq, 5 dəq) təkrar cəhd edin və bu müddətdə son uğurlu siyahıdan istifadə etməyə davam edin. |
Boş siyahı#
otelde: [] oteldə check-in etmiş qonaq olmadığını bildirir; mövsümdən kənar kiçik otellər üçün bu, normaldır. Lakin əvvəlki sorğuda dolu olan siyahının birdən boş gəlməsi adətən otel tərəfindəki əməliyyat səhvinə (yanlış kütləvi check-out, rezervasiya statusunun dəyişməsi) işarədir. Bütün Wi-Fi hesablarını bağlamazdan əvvəl siyahının ardıcıl iki sorğuda boş gəldiyinə əmin olun.
Təkrar cəhdlər və vaxt aşımları#
- Sorğu üçün 10 saniyəlik vaxt aşımı təyin edin; böyük otellərdə belə siyahı bu müddət ərzində qayıdır.
5xxvə şəbəkə xətalarında təkrar cəhd edin; konfiqurasiya xətaları olan401,404və405üçün təkrar cəhd etməyin.- Sorğu uğursuz olduğu müddətdə son uğurlu siyahını saxlayın. Hesabları yalnız uğurlu cavabda siyahıdan çıxan qonaqlar üçün bağlayın.
- Ardıcıl uğursuzluqları sayın və müəyyən həddi (məs. 15 dəqiqə) keçdikdə administratoru xəbərdar edin.
Tez-tez rast gəlinən hallar#
| Hal | Ehtimal olunan səbəb | Nə etməli |
|---|---|---|
| Qonaq siyahıda yoxdur | Resepsiya qonağın check-in əməliyyatını etməyib, rezervasiya ləğv edilib, qonaq “oteldə” kimi işarələnməyib və ya artıq check-out edib. | Portalda “otaq nömrəsi və soyad uyğun gəlmədi” mesajını göstərin və qonağı resepsiyaya yönləndirin. Siyahını yenidən almağa ehtiyac yoxdur; qonaq növbəti sinxronizasiyada görünəcək. |
| Eyni otaq üçün bir neçə qeyd | Otaqda birdən çox qonaq qalır; hər biri ayrıca qeyddir. | Normaldır. Hesabları hər qonaq üçün ayrıca açın (unique). |
identityNumber boşdur | Qonaq şəxsiyyət məlumatları olmadan qeydiyyata alınıb. | Uyğunlaşdırma üçün soyad + doğum tarixindən istifadə edin; Türkiyənin 5651 saylı qanunu üzrə qeyddə sahəni boş saxlayın və qeydi unique ilə əlaqələndirin. |
roomName uyğun gəlmir | Qonaq “104” əvəzinə “0104” və ya “Room 104” yazıb; dəyər sətirdir. | Müqayisədən əvvəl hər iki tərəfi normallaşdırın; rəqəmə çevirməyin. |
checkout keçmişdədir, amma qonaq hələ siyahıdadır | Qonaq qalma müddətini uzadıb və ya gec check-out edir, resepsiya isə bunu hələ qeydə almayıb. | Qonaq siyahıda olduğu müddətdə çıxışı açıq saxlayın; checkout dəyişdikdə sessiyanın bitmə vaxtını yeniləyin. |