Online Booking API

OnlineHMS API V2API del motore di prenotazione

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 endpoint

L’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 endpoint

Due 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 endpoint

La 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 endpoint

Elenca 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 endpoint

Convalida 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 endpoint

Extra 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 endpoint

Dati 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 endpoint

Elenchi 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

Guide

Ultimo aggiornamento: 21 settembre 2026Hai trovato un errore? Segnalacelo