Interfejsi komunikon me një Server Amadeus HotSOS përmes API-ve REST.
Interfejsi sinqronizon vetëm të dhënat e dhomave dhe jo ngjarjet. Nëse kjo është e nevojshme, kontaktoni Supportin e Antcas.
Shënim: Interfejsi është shumë i ngadaltë gjatë dërgimit. Mungesa e një vlerë në Monitor mund të zgjasë disa sekonda.
Përgjegjësi nga serveri Antcas bëhen përmes HTTPS tek portali HotSOS. URL e API-së është fiks dhe nuk mund të ndryshohet. Kështu, kërkohet informacioni i dhomave që janë përcaktuar më parë në aplikacionin HotSOS dhe në konfigurimin e Antcas. Numri maksimal i kërkimeve është 30 për minutë si standard. Serveri Antcas ndjek rregullat e vendosura për të ulur ngarkesën në anën tjetër dhe në rrjetë. Kjo do të thotë se mund të duhen disa minuta për të marrë një ndryshim tek serveri Antcas.
Në fillim të nisjes së serverit, mesazhet merren gjithmonë para se të transferohen të gjitha statuset e mesazheve. Nëse ndodh një ndryshim midis tyre nga ana e HotSOS, kjo do të thotë që statusi arrin parë në SPS dhe pastaj dërgohet përsëri.
Nëse ndodh një gabim i lidhjes, kërkimi ripërsëritet automatikisht pasi kalon koha e pritur. Gabimi shfaqet vetëm një herë në Monitor. Nëse nuk arrin të lidhet brenda kohës së caktuar për lidhje, interfejsi deklarohet si offline.
Adresa e synimit është adresa e serverit pa URI dhe prefix https://.
Shënim: Kur përdoret një server proxy, duhet të kujdesoheni që rruga URI të mos ndryshojë.
Monitori mund të shfaqë burime të ndryshme. Në tabelat e mëposhtme shpjegohen të gjitha mundësitë.
| Burimi | Përshkrimi |
|---|---|
| Klienti | Vlera që arrin nga pjesa tjetër e HotSOS. |
| Serveri | Vlera e dërguar ose lexuar nga Antcas Control. |
| Sistemi | Mesazhi i përgjithshëm i sistemit. |
| Emri | Lloji i të Dhënave | Përshkrimi |
|---|---|---|
| string | Vendos numrin e dhomës sipas interfejsit. | |
| bool | Kërko për të pastruar dhomën. | |
| string | Statusi aktual i shërbimit të dhomës. | |
| string | Statusi i dhomës. | |
| string | Emri i dhomës i marrë. | |
| bool | Do Not Disturb i marrë. | |
| bool | Dhoma është e zënë. |
Shënim: Vetëm këto vlera mund të dërgohen. Të gjitha vlerat tjera nuk dërgohen dhe shfaqen në Monitor me ngjyrë të kuqe.
| Vlera | Përshkrimi |
|---|---|
| CLEAN | Dhoma është e pastër. |
| DIRTY | Dhoma është e ndyrë. |
| OUT_OF_ORDER | Dhoma është e dëmtuar. |
| OUT_OF_SERVICE | Dhoma është jashtë shërbimit. |
| INSPECTED | Dhoma është e inspektuar. |
| PICKUP | Dhoma është në statusin e marrjes. |
Shënim: Vetëm vlerat AWAITING_SERVICE dhe DO_NOT_DISTURB mund të dërgohen.
| Vlera | Përshkrimi |
|---|---|
| AWAITING_SERVICE | Dhoma pritet të pastruar. |
| DO_NOT_DISTURB | Mikpritësi nuk dëshiron të përzihen. |
| VACANT_CLEANED | Dhoma është e pastër dhe e lirë. |
| OCCUPIED_CLEANED | Dhoma është e pastruar dhe e zënë. |
| CLEANING_STARTED | Pastrimi i dhomës ka filluar. |
| SERVICE_REFUSED | Mikpritësi ka refuzuar shërbimin. |
| STOPPED | Pastrimi është ndalur. |
| TO_BE_INSPECTED | Dhoma duhet të inspektohet. |
| INSPECTED | Dhoma është e inspektuar. |
| LATE_SERVICE | Mikpritësi dëshiron një shërbim të vonë. |
| RETURN_LATER | Mikpritësi ka kërkuar një kthim më vonë. |