# Werken met meerdere versies Met API-contracten kunt u meerdere versies van hetzelfde API-contract beheren, zodat u een gepubliceerde versie stabiel kunt houden terwijl u wijzigingen voorbereidt in een nieuwe versie. * Onderhoud een bestaande API-versie in productie terwijl u breaking changes introduceert in een nieuwe versie. * Volg en beheer gepubliceerde versies vanuit één locatie. * Werk aan API-wijzigingen zonder bestaande versies te beïnvloeden. Wanneer u een nieuwe versie maakt, wordt alle inhoud naar de nieuwe versie gekopieerd. De nieuwste versie kan vervolgens onafhankelijk worden bijgewerkt zonder eerdere versies te beïnvloeden. Alleen de meest recente versie kan worden bewerkt en u kunt alleen hiervan een nieuwe versie maken. Oudere versies zijn alleen-lezen. De startpagina van API-contracten toont alle API's waarvan u eigenaar bent en alle API-versies die met u zijn gedeeld.![Startpagina van API-contracten.](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/api-designer-homepage.png) ## Een nieuwe API-versie maken Maak een nieuwe versie van een bestaande API-definitie. Informatie Opmerking: U kunt alleen een nieuwe versie maken op basis van de meest recente versie. Oudere versies zijn alleen-lezen en kunnen niet worden bewerkt of worden gebruikt om een nieuwe versie te maken. U bent een eigenaar van de API of een bewerker van ten minste één versie van de API. 1. Ga op de startpagina naar de API waarvoor u een nieuwe versie wilt maken. U kunt de lijst filteren op naam of eigenaar indien nodig. 2. Open de nieuwste versie om het Voorbeeld te bekijken en klik vervolgens op Een nieuwe versie maken. ![Weergave van de Contacts API en de knop Nieuwe versie maken.](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/publish_version.png) 3. Voer de nieuwe versie in. 4. Klik op Maken. Er wordt een nieuwe versie van uw API gemaakt met dezelfde inhoud als de meest recente versie. De mock en documentatie zijn standaard uitgeschakeld. ## Een API-versie publiceren naar Qlik Catalog Publiceer een versie van een API-contract naar een Qlik-ruimte zodat samenwerkers deze kunnen vinden in Qlik Catalog. U bent een eigenaar van de API of een bewerker van de API-versie. Wanneer u een versie publiceert, wordt de contractversie onveranderlijk en alleen-lezen in API-contracten. Om wijzigingen aan te brengen, maakt u een nieuwe versie op basis van de meest recente versie en werkt u verder aan de nieuwe versie. 1. Klik op de startpagina op de versie die u wilt publiceren om het Voorbeeld te openen en klik vervolgens op Publiceren. ![Weergave van de Contacts API en de knop Publiceren.](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/publish_version.png) 2. Selecteer in het publicatiedialoogvenster de Qlik-ruimte waarin u de versie wilt publiceren. 3. Bekijk het versievoorbeeld en voer een publicatieopmerking in. 4. Klik op Publiceren. De geselecteerde versie wordt gepubliceerd naar de gekozen Qlik-ruimte en wordt alleen-lezen in API Contracts. Als u het contract opnieuw moet bewerken, maak dan eerst een nieuwe versie aan. ## Een API-versie verwijderen U bent een eigenaar van de API. 1. Klik op de startpagina op de knop ![Menu](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) naast de versie die u wilt verwijderen en klik op Verwijderen. 2. Klik op Verwijderen om te bevestigen. De geselecteerde versie is verwijderd. Als u een volledige API wilt verwijderen, moet u elke versie verwijderen. ## Versie-inhoud importeren Importeer inhoud van een bestaand contract in een API-versie, waarbij de huidige inhoud wordt vervangen of samengevoegd. U bent een eigenaar van de API of een bewerker van de API-versie. Gebruik deze functie om een versie bij te werken vanuit een extern contractbestand zonder een nieuwe versie aan te maken. De versie-identificatiecode blijft behouden tijdens de import. Dit verschilt van [het importeren van een definitie](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/APIDesigner/ImportingDefinition.htm "Importeer een bestaande API-definitie in API Contracts."), waarmee een nieuwe API wordt gemaakt in API Contracts. 1. Open Versie-inhoud importeren voor de versie die u wilt bijwerken. Deze actie is niet beschikbaar voor een alleen-lezenversie. U hebt toegang tot deze actie vanaf de volgende locaties: * Klik op de startpagina op ![Menu](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) naast de versie en klik op Versie-inhoud importeren. ![Optie Versie-inhoud importeren in de menuknop.](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-2.png) * Klik in het Voorbeeld van de versie op ![Menu](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/apis_menu.png) > Versie-inhoud importeren. ![Versiedetailweergave](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-3.png) * Klik in de versie-editor op Bewerken > Versie-inhoud importeren. ![Optie Versie-inhoud importeren in de versie-editor.](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content.png) 2. Selecteer een indeling en een bron voor het te importeren contract. U kunt importeren vanuit een lokaal bestand, een URL of tekst die u rechtstreeks in het dialoogvenster plakt. 3. Selecteer onder Gedrag hoe de geïmporteerde inhoud moet worden toegepast. * Vervangen: overschrijft alle huidige inhoud met het geïmporteerde contract. De API-naam, versie-identificatie en specificatieversie worden behouden. * Samenvoegen: combineert de geïmporteerde inhoud met de inhoud van de bestaande versie. De API-naam en versie-id blijven behouden. Als een geïmporteerd element dezelfde naam heeft als een bestaand element, wordt het geïmporteerde element hernoemd met een achtervoegsel \_merge (bijvoorbeeld User\_merge). Dubbele basis-URL's en mediatypen worden overgeslagen. ![Dialoogvenster Versie-inhoud importeren.](https://help.qlik.com/nl-NL/cloud-services/Subsystems/Hub/Content/Resources/Images/ApiDesigner/import-version-content-dialobox.png) 4. Klik op Importeren. De versie-editor wordt geopend met de bijgewerkte inhoud toegepast.