Werken met meerdere versies | Qlik Cloud Help
Ga naar hoofdinhoud Ga naar aanvullende inhoud

Werken met meerdere versies

Laatst bijgewerkt: 20-10-2026

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.

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.
  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.
  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 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, 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 naast de versie en klik op Versie-inhoud importeren.
      Optie Versie-inhoud importeren in de menuknop.
    • Klik in het Voorbeeld van de versie op Menu > Versie-inhoud importeren.
      Versiedetailweergave
    • Klik in de versie-editor op Bewerken > Versie-inhoud importeren.
      Optie Versie-inhoud importeren in de versie-editor.
  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.
  4. Klik op Importeren.

De versie-editor wordt geopend met de bijgewerkte inhoud toegepast.

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een tikfout, een ontbrekende stap of een technische fout – laat het ons weten!