In questa pagina
No, non una che tu possa usare per le tue prenotazioni. A ottobre 2026 il centro assistenza di Little Hotelier non documenta alcuna chiave API che una struttura possa usare per prenotazioni, ospiti o fatture: le API di SiteMinder sono per partner tecnologici certificati e l'unica chiave che puoi generare da solo, la Direct Booking API, copre tariffe, disponibilità e dati della struttura per un sito di prenotazione. Per leggere i tuoi dati da uno script, un foglio di calcolo o un assistente AI puoi usare un'API REST indipendente come Hotelier Tools, che si collega con il tuo login di Little Hotelier.
Qui sotto: cosa offre esattamente SiteMinder, poi una configurazione di cinque minuti con esempi curl reali.
Little Hotelier ha un'API pubblica?
Ci sono quattro modi ufficiali per far entrare o uscire dati da Little Hotelier. Nessuno ti dà una chiave API per l'elenco delle tue prenotazioni.
| Opzione ufficiale | Chi può usarla | Cosa copre |
|---|---|---|
| SiteMinder Exchange (SMX) | App di partner certificati | Prenotazioni da Little Hotelier. Non disponibilità né tariffe |
| Direct Booking API | Strutture che usano Direct Booking | Prezzi in tempo reale, disponibilità, struttura, tipologie di camera, piani tariffari |
| Esportazioni CSV | Qualsiasi utente, a mano | Prenotazioni, ricavi, fatture, contabilità |
| App dell'App Store | Qualsiasi struttura, tramite il fornitore dell'app | Ciò che quell'app sincronizza |
SiteMinder Exchange (SMX): per le aziende di software
La guida per sviluppatori di SiteMinder elenca cinque API: pmsXchange, SiteConnect, Channels Plus, SMX e Direct Booking. Quella che conta per Little Hotelier è SMX, l'API dietro app come il check-in online e la messaggistica con gli ospiti.
Nell'elenco dei publisher SMX di SiteMinder, Little Hotelier invia le prenotazioni ma non disponibilità e tariffe. La guida rapida di SMX dice lo stesso: "non è possibile ottenere dati ARI" da Little Hotelier.
L'accesso è riservato ai partner. Le FAQ di SiteMinder dicono che devi prima firmare un accordo di partnership tramite la candidatura per le integrazioni, poi sviluppare, certificare e andare in produzione, cosa che "la maggior parte" dei partner completa entro 60 giorni. È un percorso adatto a un'azienda di software. Un singolo hotel non può ottenere una chiave SMX per sé.
La Direct Booking API: l'unica chiave che puoi generare
Se il tuo account è sulla piattaforma più recente di Little Hotelier (iscrizioni dal maggio 2025 o account aggiornati), il centro assistenza documenta una Direct Booking API:
- Vai su Direct booking → Configuration → API integration.
- Clicca su Generate key.
- Dai la chiave e la guida per sviluppatori di SiteMinder al tuo sviluppatore web.
Restituisce prezzi e disponibilità in tempo reale, dati della struttura, tipologie di camera e piani tariffari, così uno sviluppatore può creare una pagina di prenotazione o un'app personalizzata. È inclusa in Direct Booking senza costi aggiuntivi. Non restituisce prenotazioni, ospiti, pagamenti o fatture, e l'assistenza di Little Hotelier non ti aiuta a sviluppare o correggere ciò che crei con essa.
Esportazioni CSV e App Store
Tutto il resto è manuale o gestito dal fornitore. La pagina Reservations e la maggior parte dei report esportano un CSV (passo per passo in come esportare le prenotazioni in Excel). Le app dell'App Store di Little Hotelier si collegano contattando il fornitore dell'app: i dati non li ottieni tu. Leggi le migliori integrazioni per Little Hotelier per vedere cosa c'è.
Come estrarre i tuoi dati di Little Hotelier in modo programmatico
Hotelier Tools è una dashboard indipendente per le strutture che usano Little Hotelier. Include un'API REST (stato: beta) e un server MCP per gli assistenti AI.
Come funziona, in parole semplici:
- Colleghi una volta sola il tuo login di Little Hotelier, in Credentials (
/credentials). Viene salvato cifrato (AES-256-GCM). - Hotelier Tools usa poi gli stessi endpoint web che usa l'app web di Little Hotelier. Può leggere e fare ciò che quel login può fare, niente di più.
- I tuoi script chiamano Hotelier Tools con una chiave API e Hotelier Tools parla con Little Hotelier.
Come creare una chiave API e fare la prima chiamata
Ti serve un account Hotelier Tools (registrati su dashboard.hotelier.tools/register) con Little Hotelier collegato in Credentials. Il proprietario della struttura ha l'accesso all'API per impostazione predefinita.
- Apri Developer → API & MCP → API Keys (
/developer/api-keys). - Sotto "Generate a new key", scrivi un nome che riconoscerai in seguito, come
sheets-export, e premi Generate key. - Copia subito la chiave. La pagina avverte: "Copy this key now — it will not be shown again." Le chiavi iniziano con
htk_.
- Verifica che l'API risponda. Questa chiamata è pubblica e non richiede chiave:
curl https://dashboard.hotelier.tools/api/v1/health
- Ora una chiamata con la tua chiave. Restituisce l'ID della tua struttura su Little Hotelier e il login che usa:
curl -H "Authorization: Bearer htk_YOUR_API_KEY" \
https://dashboard.hotelier.tools/api/v1/property
Su Windows, in PowerShell scrivi curl.exe invece di curl, oppure usa il comando di PowerShell:
$headers = @{ Authorization = "Bearer htk_YOUR_API_KEY" }
Invoke-RestMethod -Headers $headers -Uri "https://dashboard.hotelier.tools/api/v1/property"
Cosa può fare una chiave: non ci sono ambiti (scope). Una chiave agisce sulla struttura per cui è stata creata, come la persona che l'ha creata, con i permessi che quella persona ha in quel momento. Ogni persona può avere fino a 10 chiavi e puoi revocarle dalla stessa pagina.
Preferisci cliccare invece di scrivere comandi? Usa l'explorer
Apri REST API & Swagger (/developer/rest-api). In Quick authorize, incolla la chiave in "Bearer token (API key or session JWT)" e premi Authorize Swagger, oppure premi Use my session per saltare la chiave. Poi prova qualsiasi endpoint nell'"Interactive API explorer". La pagina ha anche Download spec e "Code templates" in cURL, JavaScript, Python e PowerShell.
Quali endpoint puoi usare?
L'URL di base è https://dashboard.hotelier.tools/api/v1. L'elenco completo e aggiornato è nella specifica OpenAPI pubblica. Questi sono quelli da cui parte la maggior parte delle persone:
| Metodo | Percorso | Cosa ottieni |
|---|---|---|
| GET | /reservations | Prenotazioni per data di check-in, con status e limit opzionali |
| GET | /reservations/{id} | Dettagli completi di una prenotazione (id numerico o riferimento LH…) |
| GET | /reservations/{id}/invoices | Le fatture di una prenotazione |
| GET | /reservations/{id}/invoices/{invoiceId}/download | Una fattura in PDF |
| POST | /reservations/{id}/invoices | Crea una nuova fattura in Little Hotelier (nessuna email all'ospite) |
| GET | /guests | Ricerca ospiti per testo, nome, email o telefono |
| GET | /prices | Tariffe e disponibilità per un intervallo di date |
| GET | /room-types | Tipologie di camera con il numero di camere di ciascuna |
| GET | /methods | I metodi nativi di Little Hotelier che puoi chiamare (pubblico) |
| POST | /methods/{methodName} | Esegue uno di essi, per esempio getReservationsByDateRange |
Alcuni esempi da copiare e incollare (date e ID sono inventati):
# Prenotazioni con check-out effettuato e check-in a novembre 2026
curl -H "Authorization: Bearer htk_YOUR_API_KEY" \
"https://dashboard.hotelier.tools/api/v1/reservations?startDate=2026-11-01&endDate=2026-11-30&status=checked_out&limit=100"
# Tutto su una prenotazione
curl -H "Authorization: Bearer htk_YOUR_API_KEY" \
"https://dashboard.hotelier.tools/api/v1/reservations/LH00000000000001"
# Tariffe e disponibilità per una settimana
curl -H "Authorization: Bearer htk_YOUR_API_KEY" \
"https://dashboard.hotelier.tools/api/v1/prices?startDate=2026-12-01&endDate=2026-12-07"
# Trova un ospite per cognome
curl -H "Authorization: Bearer htk_YOUR_API_KEY" \
"https://dashboard.hotelier.tools/api/v1/guests?lastName=Garcia&perPage=50"
# Ogni prenotazione che si sovrappone a un intervallo (metodo nativo, parametri con nome)
curl -X POST "https://dashboard.hotelier.tools/api/v1/methods/getReservationsByDateRange" \
-H "Authorization: Bearer htk_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"params":{"startDate":"2026-11-01","endDate":"2026-11-30"}}'
Le chiamate di elenco restituiscono un JSON come { "success": true, "count": 2, "data": [ … ] }. Per provare un metodo nativo senza codice, apri LH Methods (/methods) nella dashboard ed eseguilo dal browser. Le esecuzioni vengono registrate in Run History.
Provalo nella demo
Apri la stessa schermata nella demo di Hotelier Tools, con dati inventati. Senza registrazione e senza installare nulla.
Limiti, errori e cosa non è disponibile
Limite di richieste. 100 richieste al minuto per indirizzo IP. Ogni risposta contiene X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Oltre il limite ricevi 429 con un'intestazione Retry-After.
Paginazione. /reservations restituisce al massimo 100 risultati per chiamata (limit, predefinito 50) e filtra sulla data di check-in. Per un anno di dati, chiedi un mese alla volta; se un mese restituisce esattamente 100 risultati, dividilo in due. /guests pagina con page e perPage (fino a 50). /prices divide in blocchi gli intervalli più lunghi di due settimane, quindi gli intervalli lunghi sono più lenti.
Gli errori arrivano come JSON con statusCode e statusMessage:
| Codice | Di solito significa |
|---|---|
| 401 | Chiave mancante, errata o revocata |
| 404 | Prenotazione inesistente o non della tua struttura |
| 422 | Un parametro è sbagliato, per esempio una data non in formato YYYY-MM-DD |
| 429 | Troppe richieste; attendi Retry-After |
| 500 / 502 | Little Hotelier non ha risposto; riprova più tardi |
I dati mascherati restano mascherati. L'API legge ciò che Little Hotelier conserva ancora. Little Hotelier maschera i dati degli ospiti 180 giorni dopo il check-out e nessuna API può riportarli indietro. Esporta prima.
Non disponibili: webhook in uscita o notifiche in tempo reale, una chiave sandbox pubblica e pacchetti SDK su npm o PyPI. Per eseguire qualcosa a intervalli regolari usa un tuo scheduler (un cron job, l'Utilità di pianificazione di Windows o un trigger di Google Sheets).
Le scritture sono reali. POST /reservations/{id}/invoices crea ogni volta un nuovo documento di fattura in Little Hotelier. Inizia con chiamate in sola lettura e tieni le chiavi lontane da fogli di calcolo condivisi e codice pubblico.
Cosa puoi costruire?
- Un foglio prenotazioni sempre aggiornato. Porta i soggiorni del mese scorso in Google Sheets o Excel a intervalli regolari: leggi esportare le prenotazioni in Excel e Google Sheets.
- Pacchetti per il commercialista. Scarica i PDF delle fatture per prenotazione, oppure salta il codice con lo ZIP trimestrale in scaricare tutte le fatture in una volta.
- Dashboard. Porta occupazione e ricavi in Looker Studio o Power BI da un foglio che l'API tiene aggiornato.
- Assistenti AI. La stessa chiave funziona con il server MCP di Hotelier Tools (
https://dashboard.hotelier.tools/api/mcp), che offre a Claude, ChatGPT, Cursor o VS Code più di 100 strumenti per l'hotel. Parti da cos'è un server MCP, poi collega Claude o configura Claude Code, Cursor e VS Code. - Collante tra strumenti. Dove non esiste un'app nell'App Store, un piccolo script può spostare dati tra Little Hotelier e il resto dei tuoi strumenti. Confronta le opzioni in le migliori integrazioni per Little Hotelier.
Prossimi passi
- Se sviluppi software per molti hotel, candidati al programma partner di SiteMinder e a SMX.
- Se ti servono solo i dati della tua struttura, crea una chiave Hotelier Tools su
/developer/api-keyse chiama/reservations. - Esporta i dati degli ospiti che devi conservare prima che Little Hotelier li mascheri a 180 giorni.
- Tutto ciò che offrono l'API e il server MCP è nella pagina della funzione API & MCP.
Domande frequenti
Little Hotelier ha un'API pubblica per le mie prenotazioni?
Non una che una struttura possa usare per le proprie prenotazioni, a ottobre 2026. Le API di SiteMinder sono per partner tecnologici certificati e la chiave Direct Booking API che puoi generare da solo copre solo tariffe, disponibilità e dati della struttura per un sito di prenotazione.
Cos'è SiteMinder Exchange (SMX) e include Little Hotelier?
SMX è l'API di SiteMinder per le app partner, come check-in, messaggistica e strumenti di revenue. La guida per sviluppatori di SiteMinder indica Little Hotelier come fonte di prenotazioni per SMX, ma non di disponibilità e tariffe. Si collegano solo i partner certificati.
Come si diventa partner di integrazione di SiteMinder e quanto tempo ci vuole?
Si invia il modulo di candidatura per le integrazioni di SiteMinder, si firma un accordo di partnership, poi si sviluppa, si certifica e si va in produzione. SiteMinder dice che la maggior parte delle integrazioni richiede circa 60 giorni dall'inizio al lancio. È pensato per aziende di software, non per un singolo hotel.
Un'API non ufficiale come Hotelier Tools è sicura e consentita?
Hotelier Tools accede con il tuo login di Little Hotelier, lo conserva cifrato (AES-256-GCM) e può fare solo ciò che quel login può fare nell'app web di Little Hotelier. Non è un'integrazione ufficiale di SiteMinder, quindi se hai dubbi controlla il tuo contratto con SiteMinder. Puoi revocare ogni chiave in qualsiasi momento.
Little Hotelier ha un server MCP per gli assistenti AI?
Non per i gestori, a ottobre 2026. Il lavoro di SiteMinder sull'AI in Demand Plus riguarda i viaggiatori che trovano e prenotano le tue camere in ChatGPT e Claude. Per interrogare un'AI sulle tue prenotazioni serve un server MCP indipendente, come quello di Hotelier Tools.
Posso provare l'API senza rischiare dati reali?
Non esiste una chiave sandbox pubblica. Inizia con chiamate in sola lettura (prenotazioni, prezzi, tipologie di camera): non modificano nulla in Little Hotelier. Le chiamate che scrivono, come generare una fattura, creano documenti reali.
