Hata yanıtları

Hotspot API iki tür sonuç üretir: kimlik doğrulama hatası (HTTP 401) ve başarılı yanıt (HTTP 200). Boş misafir listesi bir hata değildir. Aşağıda karşılaşabileceğiniz durumlar ve her birinde yapılacaklar listelenmiştir.

HTTP durum kodları#

Kod	Gövde	Anlamı ve yapılacaklar
`200`	`{"success": 1, "otelde": [...]}`	Başarılı. Listeyi işleyin.
`200`	`{"success": 1, "otelde": []}`	Başarılı; otelde misafir yok. Aşağıdaki boş liste notuna bakın.
`401`	`{"success": 0}`	`ApiKey` başlığı yok ya da anahtar tanınmıyor. Yeniden denemeyin; anahtarı kontrol edin ve yöneticiyi uyarın.
`404`	Hata sayfası	Yol yanlış. Yolun tam olarak `/public/json/customer/inhotel` olduğunu doğrulayın.
`405`	Hata sayfası	`POST` dışında yöntem kullanıldı (örn. tarayıcıdan `GET`).
`5xx` / zaman aşımı	—	Geçici sunucu ya da ağ hatası. Artan aralıkla (30 sn, 1 dk, 5 dk) yeniden deneyin; bu sırada son başarılı listeyi kullanmaya devam edin.

Boş liste#

otelde: [] otelde check-in yapılmış misafir olmadığı anlamına gelir ve küçük otellerde sezon dışında normaldir. Ancak bir önceki sorguda dolu olan listenin aniden boşalması genellikle otel tarafında bir işlem hatasına (yanlış toplu çıkış, rezervasyon durumu değişikliği) işaret eder. Tüm Wi-Fi hesaplarını kapatmadan önce listenin iki ardışık sorguda boş geldiğini doğrulayın.

Yeniden deneme ve zaman aşımı#

İstek zaman aşımını 10 saniye tutun; liste büyük otellerde bile bu sürede döner.
5xx ve ağ hatalarında yeniden deneyin; 401, 404 ve 405 için denemeyin, bunlar yapılandırma hatasıdır.
Başarısız sorgu sırasında son başarılı listeyi koruyun. Hesapları yalnızca başarılı bir yanıtta listeden düşen misafirler için kapatın.
Art arda başarısız sorgu sayısını izleyin ve belirli bir eşikte (örn. 15 dakika) yöneticiye bildirim gönderin.

Sık karşılaşılan durumlar#

Durum	Olası neden	Yapılacak
Misafir listede yok	Resepsiyon check-in yapmamış, rezervasyon iptal edilmiş, misafir “otelde” işaretli değil ya da çıkış yapılmış.	Portalda “oda numarası ve soyad eşleşmedi” gösterin ve resepsiyona yönlendirin. Listeyi yeniden çekmek gerekmez; bir sonraki senkronda gelir.
Aynı oda için birden fazla kayıt	Odada birden fazla misafir kalıyor; her biri ayrı kayıttır.	Normal. Hesabı misafir başına (`unique`) açın.
`identityNumber` boş	Misafir kimlik bilgisi girilmeden kaydedilmiş.	Eşleştirmede soyad + doğum tarihi yedeğini kullanın; 5651 kaydında alanı boş bırakıp `unique` ile ilişkilendirin.
`roomName` eşleşmiyor	Misafir “104” yerine “0104” ya da “Oda 104” yazmış; değer bir metindir.	Karşılaştırmadan önce iki tarafı da normalize edin; sayıya çevirmeyin.
`checkout` geçmişte ama misafir listede	Misafir çıkış yapmadan konaklamayı uzatmış ya da geç çıkış yapıyor; resepsiyon henüz işlem yapmamış.	Misafir listede olduğu sürece erişimi açık tutun; süreyi `checkout` değişince güncelleyin.

Son güncelleme: 8 Eylül 2026Bu sayfada bir hata mı var? Bize yazın