# Lavorare con più versioni Contratti API consente di gestire più versioni dello stesso contratto API, in modo da mantenere stabile una versione pubblicata mentre si preparano le modifiche in una nuova versione. * Mantenere una versione esistente dell'API in produzione introducendo al contempo modifiche che causano interruzioni in una nuova versione. * Traccia e gestisci le versioni pubblicate da una singola posizione. * Lavora sulle modifiche all'API senza influire sulle versioni esistenti. Quando crei una nuova versione, tutti i contenuti vengono copiati nella nuova versione. La versione più recente può quindi essere aggiornata in modo indipendente senza influire sulle versioni precedenti. Solo l'ultima versione è modificabile ed è possibile creare una nuova versione solo a partire da essa. Le versioni precedenti sono di sola lettura. La home page Contratti API mostra tutte le API di tua proprietà e tutte le versioni delle API condivise con te.![Homepage dei contratti API.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/api-designer-homepage.png) ## Creazione di una nuova versione dell'API Crea una nuova versione di una definizione API esistente. Nota informatica Nota: È possibile creare una nuova versione solo a partire dalla versione più recente. Le versioni precedenti sono di sola lettura e non possono essere modificate o utilizzate per creare una nuova versione. Sei un proprietario dell'API o un editor di almeno una versione dell' API. 1. Nella home page, vai all'API per cui desideri creare una nuova versione. È possibile filtrare l'elenco per nome o proprietario, se necessario. 2. Apri la versione più recente per visualizzare l'Anteprima, quindi fai clic su Crea una nuova versione. ![Vista dell'API Contatti e del pulsante Crea nuova versione.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/publish_version.png) 3. Inserire la nuova versione. 4. Fare clic su Crea. Viene creata una nuova versione della tua API con lo stesso contenuto dell'ultima versione. Il mock e la documentazione sono disabilitati per impostazione predefinita. ## Pubblicazione di una versione dell'API in Qlik Catalog Pubblica una versione di un contratto API in uno spazio Qlik in modo che i collaboratori possano trovarla in Qlik Catalog. Sei un proprietario dell'API o un editor della versione dell'API. Quando pubblichi una versione, la versione del contratto diventa immutabile e di sola lettura in Contratti API. Per apportare modifiche, crea una nuova versione a partire dall'ultima versione e continua a lavorare sulla nuova versione. 1. Nella home page, fai clic sulla versione che desideri pubblicare per aprire l'Anteprima, quindi fai clic su Pubblica. ![Vista dell'API Contacts e del pulsante Pubblica.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/publish_version.png) 2. Nella finestra di dialogo di pubblicazione, selezionare lo spazio Qlik in cui si desidera pubblicare la versione. 3. Esamina l'anteprima della versione e inserisci una nota di pubblicazione. 4. Fai clic su Pubblica. La versione selezionata viene pubblicata nello spazio Qlik scelto e diventa di sola lettura in Contratti API. Se devi modificare nuovamente il contratto, crea prima una nuova versione. ## Eliminazione di una versione dell'API Sei un proprietario dell'API. 1. Nella home page, fai clic sul pulsante ![Menu](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) accanto alla versione che desideri eliminare e fai clic su Elimina. 2. Fare clic su Elimina per confermare. La versione selezionata è stata eliminata. Se desideri eliminare un'intera API, devi eliminare ogni versione. ## Importazione del contenuto della versione Importa il contenuto da un contratto esistente in una versione API, sostituendo o unendo il relativo contenuto corrente. Sei un proprietario dell'API o un editor della versione dell'API. Utilizza questa funzionalità per aggiornare una versione da un file di contratto esterno senza creare una nuova versione. L'identificatore di versione viene mantenuto per tutta la durata dell'importazione. Ciò risulta diverso da [l'importazione di una definizione](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/APIDesigner/ImportingDefinition.htm "Importa una definizione API esistente in API Contracts."), che crea una nuova API in Contratti API. 1. Apri Importa contenuto versione per la versione che desideri aggiornare. Questa azione non è disponibile per una versione in sola lettura. È possibile accedere a questa azione dalle seguenti posizioni: * Nella home page, fai clic su ![Menu](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) accanto alla versione e fai clic su Importa contenuto della versione. ![Opzione Importa contenuto della versione nel pulsante del menu.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-2.png) * Nell'anteprima della versione, fai clic su ![Menu](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) > Importa contenuto versione. ![Vista dettagli versione](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-3.png) * Nell'editor delle versioni, fai clic su Modifica > Importa contenuto della versione. ![Opzione Importa contenuto della versione nell'editor delle versioni.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content.png) 2. Selezionare un formato e un'origine per il contratto da importare. È possibile importare da un file locale, da un URL o da testo incollato direttamente nella finestra di dialogo. 3. In Comportamento, selezionare come applicare il contenuto importato. * Sostituisci: sovrascrive tutto il contenuto corrente con il contratto importato. Il nome dell'API, l'identificatore di versione e la versione della specifica vengono mantenuti. * Unisci: combina il contenuto importato con il contenuto della versione esistente. Il nome dell'API e l'identificatore di versione vengono mantenuti. Se un elemento importato ha lo stesso nome di un elemento esistente, l'elemento importato viene rinominato con un suffisso \_merge (ad esempio, User\_merge). Gli URL di base e i tipi multimediali duplicati vengono ignorati. ![Finestra di dialogo Importa contenuto della versione.](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-dialobox.png) 4. Fai clic su Importa. L'editor di versione si apre con il contenuto aggiornato applicato.