Autentifikasiya

Hotspot API autentifikasiya üçün yalnız bir HTTP başlığından istifadə edir: ApiKey. Ayrıca giriş addımı və token yoxdur; açar hər sorğuda göndərilir.

Başlıqlar#

POST /public/json/customer/inhotel HTTP/1.1
Host: test.hms.gen.tr
ApiKey: 017f1daf2d139
HotelCode: 1000
Content-Length: 0

Açar haradan alınır#

Açar otelin HMS idarəetmə panelində API səhifəsinin Custom API tabında yaradılır. Təsvir sahəsi açarın harada istifadə olunduğunu qeyd etmək üçündür; bir neçə açar yaratmaq olar. Eyni səhifədə silinən açar dərhal etibarsız olur.

Uğursuz autentifikasiya#

Başlıq yoxdursa və ya boşdursa, yaxud açar HMS-də tapılmırsa, cavab bu gövdə ilə HTTP 401 olur:

{
    "success": 0
}

Xətanın təfərrüatı verilmir. Bu ardıcıllıqla yoxlayın: başlığın adı ApiKey-dir, dəyər paneldən kopyalanmış açarla tam eynidir və açar hələ də paneldə siyahıdadır. 401 cavabından sonra təkrar cəhd etməyin; açar düzəldilənə qədər nəticə dəyişməyəcək.

Otel konteksti#

Açar bir otelə bağlıdır; cavabda yalnız həmin otelin qonaqları olur. Bir neçə otelə xidmət edən quraşdırma üçün hər otelin öz panelindən açar alın və onları otel üzrə saxlayın. Fərqli HotelCode göndərmək başqa otelin məlumatlarını qaytarmır; oteli həmişə açar müəyyən edir.

Açarın qorunması#

• Açarı hotspot serverinin konfiqurasiyasında və ya mühit dəyişənində saxlayın; onu heç vaxt captive portal HTML-inə və ya klient tərəfindəki JavaScript-ə yerləşdirməyin.
• Siyahını alan komponent server tərəfində işləməlidir. Qonaq cihazları HMS-ə birbaşa müraciət etməməlidir; cavabda bütün qonaqların şəxsiyyət məlumatları var.
• Açarın sızdığından şübhələnirsinizsə, onu paneldə silin və yenisini yaradın. Köhnə açar silindiyi andan 401 qaytarır.