Prezentare generală

API-ul Hotspot transmite lista oaspeților cazați către sistemul hotspot (portal captiv). Pentru fiecare oaspete care a făcut check-in și încă nu a făcut check-out, HMS returnează numărul camerei, numele, numărul de identificare, data nașterii și orele de check-in/check-out. Software-ul hotspot folosește lista pentru a verifica autentificarea oaspetelui la Wi-Fi după numărul camerei și numele de familie, pentru a închide accesul la sfârșitul sejurului și pentru a asocia cu o identitate jurnalele de acces pe care le păstrează conform Legii turce nr. 5651.

URL de bază#

Endpointul se află sub URL-ul de bază de mai jos, pe calea /public/json/…. Se acceptă doar HTTPS.

https://test.hms.gen.tr

Rezumatul fluxului#

Cheia se generează o singură dată în panoul de administrare HMS al hotelului și se trimite în antetul ApiKey la fiecare cerere. Endpointul de listă returnează toți oaspeții cazați într-un singur apel; software-ul hotspot compară numărul camerei și numele de familie introduse de oaspete pe portal cu această listă, deschide contul până la data planificată de check-out și reîmprospătează lista la intervale regulate pentru a închide conturile oaspeților care au plecat. Detaliile se află în ghidul Fluxul de verificare a oaspeților.

Resurse#

Reguli generale#

• Fiecare cerere conține antetul ApiKey. Nu există pas de login și nici token.
• Endpointul se apelează cu POST; nu există corp, query string sau parametri de filtrare.
• Răspunsurile sunt JSON, iar câmpul success este numărul 1 sau 0. O autentificare eșuată returnează HTTP 401 cu {"success": 0}.
• Orele sunt marcaje de timp Unix (secunde). Data nașterii este un șir DD.MM.YYYY.
• Lista acoperă întregul hotel; nu există filtru după cameră sau dată. Faceți potrivirea în sistemul dumneavoastră și păstrați lista în cache.
• Răspunsul conține date cu caracter personal (numărul de identificare, data nașterii). Stocați doar câmpurile de care aveți nevoie și trimiteți cererea de pe propriul server, niciodată de pe dispozitivul oaspetelui.

Versionare#

Acest endpoint aparține grupului de API-uri personalizate HMS și nu are număr de versiune. Pot fi adăugate câmpuri noi fără notificare prealabilă; scrieți clientul astfel încât să ignore câmpurile pe care nu le cunoaște. Eliminarea unui câmp existent sau schimbarea semnificației acestuia se anunță din timp în notele de versiune.

Pașii următori#