Ospiti in hotel

L’unica risorsa dell’integrazione hotspot. Restituisce i dati di camera, identità e check-in/check-out di ogni ospite attualmente in hotel (check-in effettuato, check-out non ancora effettuato). Il software hotspot recupera questo elenco a intervalli regolari e apre o chiude di conseguenza gli account Wi-Fi; i passaggi sono descritti nella guida Flusso di verifica degli ospiti.

POST/public/json/customer/inhotelElenco degli ospiti in hotel

Oggetto#

Campi

uniqueinteger
ID del record di soggiorno, univoco per ospite e prenotazione. Usalo come chiave dell’utente o della sessione sul lato hotspot.
rezervasyon_idinteger
ID della prenotazione. Gli ospiti che condividono una camera hanno lo stesso valore.
inHotelinteger
1 = l’ospite è in hotel. Vale sempre 1, perché l’endpoint restituisce solo gli ospiti in hotel.
firstNamestring
Nome. Di solito in maiuscolo, come letto dal documento d’identità; più nomi sono separati da spazi.
lastNamestring
Cognome. Di solito in maiuscolo.
identityNumberstring | null
Numero di identità nazionale turco o numero di passaporto, come riportato sul documento. Può essere vuoto per gli ospiti registrati senza i dati del documento.
birthDatestring | null
Data di nascita, DD.MM.YYYY. Può essere vuota.
roomIDinteger
ID HMS della camera.
roomNamestring
Nome o numero della camera come lo vede l’ospite sulla porta e sulla chiave elettronica. Nel portale chiedilo come “numero di camera”.
checkininteger
Ora del check-in dell’ospite come timestamp Unix (secondi).
checkoutinteger
Data di check-out prevista come timestamp Unix all’inizio della giornata (00:00 UTC); non contiene l’ora. Aggiungi l’orario di check-out dell’hotel (di solito le 12:00) per ottenere la fine della sessione.
checkout2integer | null
Ora effettiva del check-out. null per gli ospiti in hotel; in ogni caso un ospite che effettua il check-out esce dall’elenco.
mikrotikSifrelemeinteger
Impostazione di cifratura Mikrotik dell’edificio della camera in HMS: 0 nome della camera (la password del Wi-Fi è il numero di camera), 1 nessuna password. Applica lo stesso criterio nel tuo portale.
01
Oggetto di esempio
{
    "mikrotikSifreleme": 0,
    "unique": 58211,
    "inHotel": 1,
    "identityNumber": "11111111110",
    "firstName": "AYŞE",
    "lastName": "DEMİR",
    "birthDate": "14.03.1985",
    "roomID": 4,
    "roomName": "104",
    "checkin": 1788863400,
    "checkout": 1788998400,
    "checkout2": null,
    "rezervasyon_id": 282799
}

Elenco degli ospiti in hotel#

POST/public/json/customer/inhotel

Autenticazione: Header ApiKey

Restituisce l’elenco completo degli ospiti in hotel. Non ci sono parametri di filtro né corpo della richiesta. Un ospite compare nell’elenco quando la prenotazione è attiva, il check-in è stato effettuato ma il check-out non ancora, e l’ospite è contrassegnato come “in hotel”. Ogni ospite della stessa prenotazione è un record separato.

La risposta non è paginata; gli hotel di grandi dimensioni possono restituire diverse centinaia di record. Metti in cache l’elenco e aggiornalo all’intervallo consigliato.

Header

ApiKeystringobbligatorio
Chiave API personalizzata generata nel pannello di amministrazione di HMS. È legata a un solo hotel, che determina di quali ospiti viene restituito l’elenco.
HotelCodeinteger
ID HMS dell’hotel. Non viene usato per la validazione, perché il server ricava l’hotel dalla chiave; è consigliato per il logging e la compatibilità.

Risposta

200 success: 1 e l’array otelde. Se non ci sono ospiti in hotel l’array è vuoto: non si tratta di un errore.

successinteger
1 successo, 0 errore. È un numero, non un booleano come in Online Booking.
otelde[]object[]
Record degli ospiti. Per i campi consulta la sezione Oggetto più sopra.

Risposte di errore

  • 401 Header ApiKey mancante o vuoto, oppure chiave non definita in HMS (potrebbe essere stata eliminata). Corpo: {"success": 0}.
  • 405 La richiesta ha usato un metodo diverso da POST (ad esempio GET dalla barra degli indirizzi del browser).
Richiesta
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
  -H "ApiKey: $HMS_API_KEY" \
  -H "HotelCode: 1000"
Risposta · 200
{
    "success": 1,
    "otelde": [
        {
            "mikrotikSifreleme": 0,
            "unique": 58211,
            "inHotel": 1,
            "identityNumber": "11111111110",
            "firstName": "AYŞE",
            "lastName": "DEMİR",
            "birthDate": "14.03.1985",
            "roomID": 4,
            "roomName": "104",
            "checkin": 1788863400,
            "checkout": 1788998400,
            "checkout2": null,
            "rezervasyon_id": 282799
        },
        {
            "mikrotikSifreleme": 0,
            "unique": 58212,
            "inHotel": 1,
            "identityNumber": "22222222220",
            "firstName": "MEHMET",
            "lastName": "DEMİR",
            "birthDate": "02.11.1982",
            "roomID": 4,
            "roomName": "104",
            "checkin": 1788863400,
            "checkout": 1788998400,
            "checkout2": null,
            "rezervasyon_id": 282799
        },
        {
            "mikrotikSifreleme": 0,
            "unique": 58197,
            "inHotel": 1,
            "identityNumber": "U01234567",
            "firstName": "JULIA",
            "lastName": "WAGNER",
            "birthDate": "27.06.1990",
            "roomID": 12,
            "roomName": "205",
            "checkin": 1788782700,
            "checkout": 1789084800,
            "checkout2": null,
            "rezervasyon_id": 282803
        }
    ]
}
Risposta · 200 (nessun ospite in hotel)
{
    "success": 1,
    "otelde": []
}
Risposta · 401 (chiave non valida)
{
    "success": 0
}
Ultimo aggiornamento: 21 settembre 2026Hai trovato un errore? Segnalacelo