Prezentare generală

API-ul Online Booking conectează motorul de rezervări de pe site-ul propriu al hotelului la HMS Software Hotelier. Listele de camere și tarife, disponibilitatea în calendar, validarea cupoanelor, pasul de plată și transmiterea rezervării în HMS trec toate prin acest API. Este conceput pentru agențiile care dezvoltă motoare de rezervări și pentru partenerii HMS.

URL de bază#

Toate endpointurile se află sub URL-ul de bază de mai jos, pe calea /external/…. Se acceptă doar HTTPS.

URL-ul de bază al API-ului

https://test.hms.gen.tr

Fluxul pe scurt#

1LoginPOST /external/public/login

2Camere și tarifePOST /external/online/roomType

3PlatăPOST …/payment/type/{type}

4RezervarePOST …/channel/booking

Tokenul obținut la login este valabil 7 zile și este legat de un singur hotel. Lista de camere returnează camerele vandabile și prețurile pentru datele și numărul de persoane căutate de oaspete; după ce oaspetele a ales și tipul de plată este stabilit, rezervarea este scrisă în HMS ca BookingPushRQ. Ghidul Fluxul de rezervare parcurge fiecare pas.

Resurse#

Resursă	Endpointuri
Autentificare	POST `/external/public/login`
Camere și tarife	POST `/external/online/roomType` GET `/external/room/type/hotel/availability`
Rezervare	POST `/external/online/channel/booking`
Plată	GET `/external/online/payment/type` GET `/external/payment/company` POST `/external/online/payment/type/{paymentType}`
Cupon	POST `/external/online/coupon/search`
Pachete și servicii suplimentare	GET `/external/stock/packages`
Informații despre hotel	GET `/external/hotel/{hotelID}/contact/info` GET `/external/online/social/media` GET `/external/online/footer` GET `/external/online/mail/host`
Nomenclatoare	POST `/external/counties` GET `/external/currencies` GET `/external/languages`

Reguli generale#

Fiecare cerere, cu excepția loginului, conține antetul Authorization: Bearer <token>.
Majoritatea endpointurilor POST primesc câmpuri de formular (application/x-www-form-urlencoded sau multipart/form-data). Transmiterea rezervării și inițierea plății așteaptă corpuri JSON. Pagina de referință a fiecărui endpoint precizează formatul.
Răspunsurile sunt JSON și conțin indicatorul success. Și erorile de logică de business vin cu HTTP 200; evaluați rezultatul după success, nu după codul de stare.
Datele au formatul YYYY-MM-DD, sumele sunt șiruri cu două zecimale ("965.00"), iar moneda provine din setările canalului online al hotelului.
Parametrul hotelID trebuie să corespundă hotelului de care este legat tokenul.

Versiune#

Această documentație acoperă HMS API V2. Pot fi adăugate câmpuri și endpointuri noi fără notificare prealabilă; scrieți clientul astfel încât să ignore câmpurile necunoscute. Modificările sunt listate în notele de versiune.

Pașii următori#

Pornire rapidăObțineți un token și trimiteți prima interogare de camere. AutentificareCheile de partener și durata de valabilitate a tokenului. Fluxul de rezervareDe la căutare la transmitere, cap-coadă. Referință APIToate endpointurile, parametrii și exemplele.

Ultima actualizare: 21 septembrie 2026Ați găsit o greșeală? Anunțați-ne