Online Booking API
Collega il motore di prenotazione del sito dell’hotel a HMS: elenco di camere e tariffe, disponibilità a calendario, coupon, pagamento e invio delle prenotazioni.
- URL di base
https://test.hms.gen.tr- Autenticazione
- apiKey / apiSecret → token Bearer
- Formato
- Risposte JSON · corpi della richiesta in formato form o JSON
- Ambito
- 8 risorse · 16 endpoint
Risorse#
Autenticazione
1 endpointL’accesso all’API Online Booking avviene con le credenziali partner rilasciate da HMS. L’endpoint di login scambia apiKey e apiSecret con un token, da…
- POST
/external/public/login
Camere e tariffe
2 endpointDue endpoint che alimentano i risultati di ricerca del motore di prenotazione: l’elenco camere, che restituisce tipologie di camera vendibili, trattam…
- POST
/external/online/roomType - GET
/external/room/type/hotel/availability
Prenotazione
1 endpointLa camera, il trattamento e la tariffa scelti dall’ospite vengono inviati a HMS in una struttura BookingPushRQ. Lo stesso endpoint gestisce cancellazi…
- POST
/external/online/channel/booking
Pagamento
3 endpointElenca i tipi di pagamento che l’hotel accetta per le prenotazioni online e avvia la fase di pagamento per il tipo selezionato. Cosa fare per ciascun …
- GET
/external/online/payment/type - GET
/external/payment/company - POST
/external/online/payment/type/{paymentType}
Coupon
1 endpointConvalida i coupon di sconto online che l’hotel ha definito nel pannello. Applica lo sconto dal tuo lato e invia gli importi scontati nella prenotazio…
- POST
/external/online/coupon/search
Pacchetti ed extra
1 endpointExtra che si possono vendere insieme a una prenotazione: pacchetti camera (legati a una tipologia di camera) e pacchetti generali (transfer, cena, spa…
- GET
/external/stock/packages
Informazioni sull’hotel
4 endpointDati che popolano gli elementi fissi delle pagine del motore di prenotazione: contatti e posizione, link ai social media, testi del footer (note legal…
- GET
/external/hotel/{hotelID}/contact/info - GET
/external/online/social/media - GET
/external/online/footer - +1 altro
Tabelle di riferimento
3 endpointElenchi statici per le opzioni dei form: paesi, valute e lingue. Cambiano raramente e si possono tenere in cache per un giorno.
- POST
/external/counties - GET
/external/currencies - GET
/external/languages
Documentazione#
Primi passi
- PanoramicaCosa fa l’API Online Booking, URL di base, sintesi del flusso e regole generali.
- Guida rapidaOttieni un token con le credenziali partner e invia la tua prima richiesta di camere e tariffe.
- AutenticazioneLogin con apiKey / apiSecret, token Bearer, contesto dell’hotel e durata del token.
- Richieste e risposteCorpi form e JSON, envelope success, paginazione, formati di date e importi, codici di stato HTTP.
- Codici di erroreValori di message ed errorCode, errori di autenticazione e indicazioni sui nuovi tentativi.