Sviluppatori: collegare un software o un assistente IA
Nel menu del tuo account, apri «Sviluppatori». La pagina si chiama «Client API». Questa voce è visibile in modalità esperto ed è contrassegnata come BETA.
Creare un client API
Per creare client API serve un abbonamento a pagamento o un periodo di prova attivo. Puoi avere fino a 5 client.
- Apri «Creare un client API». Se hai già un client, fai clic su «Nuova chiave API».
- In «Identificativo», assegna un nome alla tua integrazione per riconoscerla.
- Fai clic su «Generare una chiave API» e salva il
client_ide ilclient_secret. Il segreto viene mostrato una sola volta.
Importante
Mantieni il segreto riservato, come una password. Usalo solo sul server, mai nel codice del browser o in un’applicazione pubblica. Non incollarlo in una conversazione con un assistente IA.
Collegare il tuo software
Il software scambia queste credenziali con un token di accesso su https://api2.rentila.com/oauth/token, usando client_credentials. Poi usa il token per chiamare l’API. Riutilizzalo fino alla scadenza, quindi richiedine uno nuovo.
Apri «Istruzioni per l'accesso» per gli esempi di connessione e «Documentazione dell'API» per le operazioni e i relativi parametri.
Collegare un assistente tramite MCP
- Nel client compatibile con MCP, aggiungi un server con l’indirizzo
https://api2.rentila.com/mcp. - Avvia la connessione. Nella pagina Rentila che si apre nel browser, scegli il paese del tuo account e inserisci le credenziali abituali.
- Inserisci il codice di autenticazione a due fattori, se richiesto, e torna al client.
Non occorre creare un client API per questa connessione tramite browser. Puoi poi chiedere, ad esempio: «Elenca i miei immobili» o «Quali canoni ho incassato a ottobre?». Alcune operazioni modificano i tuoi dati: controlla la richiesta e le conferme proposte dal client.
Il pulsante «Claude MCP» copia un link di configurazione da aprire nel browser. «Claude Code», «Codex» e «Cursor» copiano un testo di configurazione da usare nello strumento scelto. Inserisci la password solo nella pagina di accesso Rentila.
Gestire i tuoi client API
L’elenco mostra nome, client_id, data di creazione e ultimo accesso. Il segreto resta nascosto. Per eliminare un client, usa l’icona del cestino e conferma.
Se perdi il segreto, crea un nuovo client e aggiorna il software. In caso di divulgazione, elimina anche il client compromesso. Se hai raggiunto il limite di 5 client, eliminane uno inutilizzato prima di crearne un altro.







