Online Booking API
Conectează motorul de rezervări de pe site-ul hotelului la HMS: lista de camere și tarife, disponibilitatea în calendar, cupoane, plata și transmiterea rezervărilor.
- URL de bază
https://test.hms.gen.tr- Autentificare
- apiKey / apiSecret → token Bearer
- Format
- Răspunsuri JSON · corp de cerere de tip formular sau JSON
- Acoperire
- 8 resurse · 16 endpointuri
Resurse#
Autentificare
1 endpointAccesul la API-ul Online Booking se face cu credențialele de partener emise de HMS. Endpointul de login schimbă apiKey și apiSecret pe un token, care …
- POST
/external/public/login
Camere și tarife
2 endpointuriDouă endpointuri care alimentează rezultatele căutării din motorul de rezervări: lista de camere, care returnează tipurile de camere vandabile, tipuri…
- POST
/external/online/roomType - GET
/external/room/type/hotel/availability
Rezervare
1 endpointCamera, tipul de masă și tariful alese de oaspete sunt transmise către HMS într-o structură BookingPushRQ. Același endpoint gestionează anulările și m…
- POST
/external/online/channel/booking
Plată
3 endpointuriListează tipurile de plată acceptate de hotel pentru rezervările online și inițiază pasul de plată pentru tipul selectat. Ce trebuie făcut pentru fiec…
- GET
/external/online/payment/type - GET
/external/payment/company - POST
/external/online/payment/type/{paymentType}
Cupon
1 endpointValidează cupoanele de reducere online definite de hotel în panou. Aplicați reducerea în sistemul dumneavoastră și trimiteți sumele reduse la transmit…
- POST
/external/online/coupon/search
Pachete și servicii suplimentare
1 endpointServicii suplimentare care pot fi vândute împreună cu o rezervare: pachete de cameră (legate de un tip de cameră) și pachete generale (transfer, cină,…
- GET
/external/stock/packages
Informații despre hotel
4 endpointuriDatele care alimentează elementele fixe ale paginilor motorului de rezervări: date de contact și localizare, linkuri către rețelele sociale, texte de …
- GET
/external/hotel/{hotelID}/contact/info - GET
/external/online/social/media - GET
/external/online/footer - +1 în plus
Nomenclatoare
3 endpointuriListe statice pentru opțiunile din formulare: țări, monede și limbi. Se schimbă rar și pot fi păstrate în cache timp de o zi.
- POST
/external/counties - GET
/external/currencies - GET
/external/languages
Documentație#
Primii pași
- Prezentare generalăCe face API-ul Online Booking, URL-ul de bază, rezumatul fluxului și regulile generale.
- Pornire rapidăObțineți un token cu credențialele de partener și trimiteți prima interogare de camere și tarife.
- AutentificareLogin cu apiKey / apiSecret, token Bearer, contextul hotelului și durata de valabilitate a tokenului.
- Cereri și răspunsuriCorpuri de tip formular și JSON, învelișul success, paginare, formatul datelor și al sumelor, coduri de stare HTTP.
- Coduri de eroareValorile message și errorCode, erori de autentificare și recomandări pentru reîncercări.