Portale per sviluppatoriHMS Gestionale Alberghiero

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 Bearer o header ApiKey
Formato
Risposte JSON con envelope success
Online
2 prodotti · 17 endpoint
In arrivo
5 prodotti
Richiesta
# 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"
Risposta · 200 (troncata)
{
    "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
}

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

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.

8 risorse · 16 endpointDocumentazione
Online

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.

1 risorsa · 1 endpointDocumentazione
In arrivo

POS Ristorante

Conti e addebiti in camera

Addebito sul conto camera dei conti di ristorante, bar e caffetteria, sincronizzazione di menu e scorte.

Documentazione in preparazione
In arrivo

Spa

Appuntamenti e servizi

Appuntamenti spa e wellness, catalogo dei servizi e integrazione con l’addebito in camera.

Documentazione in preparazione
In arrivo

AI

Assistente e servizi di raccomandazione

Accesso ai servizi di AI per l’assistente agli ospiti, i suggerimenti tariffari e la reportistica.

Documentazione in preparazione
In arrivo

TV

Sistemi TV in camera

Dati dell’ospite, conto camera, messaggi e richieste di servizio per l’interfaccia TV in camera.

Documentazione in preparazione
In arrivo

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.

Documentazione in preparazione

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.

Autenticazione

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.

Richieste e risposte

Esempi funzionanti

Per ogni endpoint vengono generati esempi in cURL, Node.js e PHP: copiali, aggiungi la tua chiave ed eseguili.

Riferimento API

Modifiche recenti

Tutte le note di rilascio

  • Sito
    Supporto per 22 lingue
    NuovoNuovo
  • Hotspot
    Pubblicata la documentazione dell’API Hotspot
    NuovoNuovo
  • Online Booking
    Pubblicata la documentazione dell’API Online Booking
    NuovoNuovoNuovo

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.