Collega il tuo software ai moduli HMS
Documentazione API separata per ogni modulo del gestionale alberghiero: motore di prenotazione, Wi-Fi per gli ospiti, POS ristorante, spa, TV, centralino e servizi di AI. Le API Online Booking e Hotspot sono già disponibili; le altre seguiranno.
- Autenticazione
- Token
Bearero headerApiKey - Formato
- Risposte JSON con envelope
success - Online
- 2 prodotti · 17 endpoint
- In arrivo
- 5 prodotti
# Richiesta di camere e tariffe
curl "https://test.hms.gen.tr/external/online/roomType" \
-H "Authorization: Bearer $HMS_TOKEN" \
-d "hotelID=1000" -d "startDate=2026-08-18" -d "endDate=2026-08-20" \
-d "adultCount=2"# Elenco degli ospiti in hotel
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
-H "ApiKey: $HMS_API_KEY" \
-H "HotelCode: 1000"{
"success": true,
"items": [
{
"id": 2,
"name": "Camera Standard",
"roomCount": 5,
"currency": "TRY",
"accommodationTypes": [
{
"id": 2,
"title": "Pernottamento e colazione",
"prices": {
"2-1": {
"total": 2,
"price": "1930.00",
"nonRefundable": ""
},
"2-0": {
"total": 2,
"price": "1737.00",
"nonRefundable": "[NR]"
}
}
}
]
}
],
"count": 1
}{
"success": 1,
"otelde": [
{
"unique": 58211,
"firstName": "AYŞE",
"lastName": "DEMİR",
"identityNumber": "11111111110",
"birthDate": "14.03.1985",
"roomName": "104",
"checkin": 1788863400,
"checkout": 1788998400,
"rezervasyon_id": 282799
}
]
}Prodotti
Ogni prodotto ha la propria documentazione, il proprio riferimento API e i propri esempi di codice. I prodotti in arrivo vengono annunciati nelle note di rilascio non appena sono disponibili.
Online Booking
API 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.
Hotspot
Wi-Fi per gli ospiti e log della legge 5651
Fornisce al sistema hotspot l’elenco degli ospiti in hotel: camera, identità, orari di check-in e check-out. Serve a verificare gli accessi Wi-Fi degli ospiti tramite il numero di camera e a conservare i log di accesso previsti dalla legge turca n. 5651.
POS Ristorante
Conti e addebiti in camera
Addebito sul conto camera dei conti di ristorante, bar e caffetteria, sincronizzazione di menu e scorte.
Spa
Appuntamenti e servizi
Appuntamenti spa e wellness, catalogo dei servizi e integrazione con l’addebito in camera.
AI
Assistente e servizi di raccomandazione
Accesso ai servizi di AI per l’assistente agli ospiti, i suggerimenti tariffari e la reportistica.
TV
Sistemi TV in camera
Dati dell’ospite, conto camera, messaggi e richieste di servizio per l’interfaccia TV in camera.
Centralino
Centralino e registro chiamate
Integrazione con il centralino telefonico: attivazione e disattivazione delle linee al check-in/out, addebito delle telefonate sul conto camera.
Principi comuni a tutti i prodotti
Dopo aver integrato un modulo, gli altri ti sembreranno familiari.
Chiave legata all’hotel
In Online Booking la coppia apiKey/apiSecret rilasciata da HMS viene scambiata con un token Bearer legato all’hotel e valido 7 giorni. Le integrazioni on-premise come Hotspot usano una chiave generata nel pannello dell’hotel, inviata nell’header ApiKey a ogni richiesta.
Envelope success
Le risposte sono in JSON e contengono un flag success. Gli errori di logica applicativa tornano come HTTP 200 con message o errorCode; gli errori di autenticazione sono 401.
Esempi funzionanti
Per ogni endpoint vengono generati esempi in cURL, Node.js e PHP: copiali, aggiungi la tua chiave ed eseguili.
Riferimento APIModifiche recenti
-
Supporto per 22 lingueNuovoNuovo
-
Pubblicata la documentazione dell’API HotspotNuovoNuovo
-
Pubblicata la documentazione dell’API Online BookingNuovoNuovoNuovo
Serve aiuto?
Il nostro team di sviluppo risponde entro un giorno lavorativo.
Includi il corpo della richiesta (con chiavi segrete e dati delle carte mascherati), la risposta e l’orario. Usa lo stesso indirizzo anche per chiavi partner, hotel di test e accesso anticipato.