L'API di Amenitiz consente a un altro sistema di collegarsi al tuo account Amenitiz e leggere i dati della tua struttura: camere, tariffe, disponibilità, prenotazioni e fatture.
La usi se vuoi collegare Amenitiz a uno strumento esterno, o se uno sviluppatore sta creando un'integrazione per la tua struttura. La configurazione è un lavoro tecnico: tu o uno sviluppatore che lavora con te dovrete scrivere del codice.
Prima di iniziare
L'API di Amenitiz è in beta ed è ancora in fase di rilascio, quindi alcuni dettagli potrebbero cambiare.
L'API è disponibile solo sul piano Advanced, e solo il titolare dell'account può creare o gestire le credenziali API. I membri del team non possono.
Cosa può leggere l'API
Quando crei una credenziale scegli cosa può leggere, tra sei aree:
Tipologie di camere e camere
Tariffe e offerte
Calendario disponibilità
Prenotazioni e dettagli degli ospiti
Conti, fatture e pagamenti in uscita
Impostazioni della struttura e team
Le ultime tre riguardano dati personali e sensibili: selezionale solo quando lo strumento ne ha davvero bisogno.
Cosa non può fare l'API
Non può modificare nulla nel tuo account. L'API si limita a leggere i dati. Tariffe, disponibilità, prenotazioni e impostazioni si modificano in Amenitiz.
Non copre tutto ciò che vedi in Amenitiz. Alcuni dati sono disponibili solo nella piattaforma.
Amenitiz non fornisce supporto tecnico per le implementazioni dell'API. È un'integrazione avanzata offerta in modalità self-service.
Passo passo
Per iniziare:
Verifica che la tua struttura sia sul piano Advanced e che tu sia il titolare dell'account.
Crea le tue credenziali API in
Impostazioni→Credenziali API. Amenitiz genera un Client ID e un segreto.Consegna il Client ID e il segreto al tuo sviluppatore, oppure incollali nello strumento che stai collegando.
Indica al tuo sviluppatore la documentazione tecnica su developers.amenitiz.com.
Questo video mostra la procedura passo passo:
📌 Nota
Pronto a collegare uno strumento? Vedi Come creare e gestire le tue credenziali API.
Mi serve uno sviluppatore per usare l'API?
Mi serve uno sviluppatore per usare l'API?
Nella maggior parte dei casi sì. L'API è un'interfaccia tecnica: o lavori con uno sviluppatore, oppure lo strumento che colleghi supporta già l'API di Amenitiz. Per creare le credenziali, invece, non serve nessuno.
L'API può modificare tariffe, disponibilità o prenotazioni?
L'API può modificare tariffe, disponibilità o prenotazioni?
No. L'API si limita a leggere i dati. Ogni modifica a tariffe, disponibilità, prenotazioni o impostazioni va fatta in Amenitiz.
Che differenza c'è tra l'API e il Marketplace?
Che differenza c'è tra l'API e il Marketplace?
Il Marketplace raccoglie collegamenti già pronti verso strumenti con cui Amenitiz lavora già, e li attivi tu senza scrivere codice. L'API serve a collegare uno strumento che non ha un collegamento già pronto, e richiede lavoro di sviluppo.
Sono sul piano Advanced ma non vedo Credenziali API
Sono sul piano Advanced ma non vedo Credenziali API
L'API è ancora in fase di rilascio, quindi potrebbe non essere ancora arrivata sul tuo account. Verifica di aver effettuato l'accesso come titolare dell'account, poi contatta il nostro team di supporto.