შეცდომის პასუხები
Hotspot API ორი სახის შედეგს აბრუნებს: ავთენტიფიკაციის შეცდომას (HTTP 401) და წარმატებულ პასუხს (HTTP 200). სტუმრების ცარიელი სია შეცდომა არ არის. ქვემოთ აღწერილია სიტუაციები, რომლებსაც შეიძლება წააწყდეთ, და რა უნდა გააკეთოთ თითოეულ მათგანში.
HTTP სტატუსის კოდები#
| კოდი | ტანი | მნიშვნელობა და რა უნდა გააკეთოთ |
|---|---|---|
200 | {"success": 1, "otelde": [...]} | წარმატება. დაამუშავეთ სია. |
200 | {"success": 1, "otelde": []} | წარმატება; სასტუმროში არავინ არის. იხილეთ ქვემოთ შენიშვნა ცარიელი სიის შესახებ. |
401 | {"success": 0} | ApiKey სათაური აკლია ან გასაღები ვერ იქნა ამოცნობილი. ნუ გაიმეორებთ; შეამოწმეთ გასაღები და აცნობეთ ადმინისტრატორს. |
404 | შეცდომის გვერდი | არასწორი ბილიკი. დარწმუნდით, რომ ბილიკი ზუსტად /public/json/customer/inhotel არის. |
405 | შეცდომის გვერდი | გამოყენებულია სხვა მეთოდი და არა POST (მაგ. GET ბრაუზერიდან). |
5xx / დროის ლიმიტის ამოწურვა | — | სერვერის ან ქსელის დროებითი შეცდომა. გაიმეორეთ მზარდი დაყოვნებით (30 წმ, 1 წთ, 5 წთ) და მანამდე ბოლო წარმატებული სია გამოიყენეთ. |
ცარიელი სია#
otelde: [] ნიშნავს, რომ სასტუმროში ჩასახლებული სტუმრები არ არიან — ეს ჩვეულებრივი ამბავია მცირე სასტუმროებისთვის არასეზონზე. თუმცა სია, რომელიც წინა მოთხოვნისას სავსე იყო და მოულოდნელად ცარიელი დაბრუნდა, ჩვეულებრივ სასტუმროს მხარეს ოპერაციულ შეცდომაზე მიუთითებს (არასწორი მასობრივი გაწერა, ჯავშნის სტატუსის ცვლილება). ყველა Wi-Fi ანგარიშის დახურვამდე დარწმუნდით, რომ სია ზედიზედ ორ მოთხოვნაზე ცარიელი დაბრუნდა.
განმეორებითი მცდელობები და დროის ლიმიტები#
- გამოიყენეთ მოთხოვნის 10-წამიანი დროის ლიმიტი; დიდ სასტუმროებშიც კი სია ამ დროში ბრუნდება.
- გაიმეორეთ მოთხოვნა
5xxდა ქსელის შეცდომების შემთხვევაში; ნუ გაიმეორებთ401,404და405პასუხებზე — ეს კონფიგურაციის შეცდომებია. - სანამ მოთხოვნა წარუმატებელია, შეინარჩუნეთ ბოლო წარმატებული სია. ანგარიშები დახურეთ მხოლოდ იმ სტუმრებისთვის, რომლებიც წარმატებულ პასუხში სიიდან გაქრნენ.
- დათვალეთ ზედიზედ წარუმატებელი მცდელობები და ზღვრის გადაჭარბებისას (მაგ. 15 წუთი) აცნობეთ ადმინისტრატორს.
ხშირი სიტუაციები#
| სიტუაცია | სავარაუდო მიზეზი | რა უნდა გააკეთოთ |
|---|---|---|
| სტუმარი სიაში არ არის | რეცეფციას სტუმარი ჯერ არ ჩაუსახლებია, ჯავშანი გაუქმდა, სტუმარი მონიშნული არ არის როგორც „სასტუმროშია“ ან უკვე გაწერილია. | პორტალზე აჩვენეთ „ოთახის ნომერი და გვარი არ ემთხვევა“ და სტუმარი რეცეფციაში გადაამისამართეთ. სიის ხელახლა მოთხოვნა საჭირო არ არის; სტუმარი შემდეგი სინქრონიზაციისას გამოჩნდება. |
| ერთი ოთახისთვის რამდენიმე ჩანაწერი | ოთახში ერთზე მეტი სტუმარი ცხოვრობს; თითოეული ცალკე ჩანაწერია. | ეს ნორმალურია. ანგარიშები თითოეული სტუმრისთვის (unique) გახსენით. |
identityNumber ცარიელია | სტუმარი პირადობის მონაცემების გარეშე დარეგისტრირდა. | შედარებისთვის გამოიყენეთ გვარი + დაბადების თარიღი; №5651 კანონის ჩანაწერში ველი ცარიელი დატოვეთ და ჩანაწერი unique მნიშვნელობას დაუკავშირეთ. |
roomName არ ემთხვევა | სტუმარმა „104“-ის ნაცვლად შეიყვანა „0104“ ან „ოთახი 104“; მნიშვნელობა სტრიქონია. | შედარებამდე ორივე მხარის ნორმალიზება მოახდინეთ; რიცხვად ნუ გადაიყვანთ. |
checkout წარსულშია, მაგრამ სტუმარი კვლავ სიაშია | სტუმარმა ყოფნა გაახანგრძლივა ან გვიან გადის, და რეცეფციას ეს ჯერ არ დაუმუშავებია. | სანამ სტუმარი სიაშია, წვდომა ღია დატოვეთ; checkout ველის ცვლილებისას სესიის დასასრული განაახლეთ. |