Utiliser plusieurs versions | Aide Qlik Cloud
Accéder au contenu principal Passer au contenu complémentaire
Ressources Qlik
Chargement de la recherche avec SearchUnify Si vous avez besoin d'aide avec votre produit, contactez le Support Qlik.
Qlik Customer Portal
Chargement de la recherche avec SearchUnify Si vous avez besoin d'aide avec votre produit, contactez le Support Qlik.
Qlik Customer Portal

Utiliser plusieurs versions

Dernière mise à jour : 20/10/2026

API Contracts vous permet de conserver plusieurs versions d'un même contrat d'API afin de conserver une version publiée stable pendant que vous préparez des modifications dans une nouvelle version.

  • Conservez une version d'API existante en production tout en introduisant des modifications majeures dans une nouvelle version.
  • Suivez et gérez les versions publiées depuis un emplacement unique.
  • Travaillez sur les modifications de l'API sans affecter les versions existantes.

Lorsque vous créez une nouvelle version, tout le contenu est copié dans la nouvelle version. La dernière version peut alors être mise à jour indépendamment, sans affecter les versions antérieures.

Seule la dernière version est modifiable, et vous ne pouvez créer une nouvelle version qu'à partir de celle-ci. Les versions antérieures sont en lecture seule.

La page d'accueil d'API Contracts affiche toutes les API que vous possédez et toutes les versions d'API partagées avec vous.
Page d'accueil d'API Contracts.

Créer une version d'API

Créez une nouvelle version d'une définition d'API existante.

Note Informations

Remarque :

Vous pouvez créer une nouvelle version uniquement à partir de la dernière version. Les versions antérieures sont en lecture seule et ne peuvent pas être modifiées ni être utilisées pour créer une nouvelle version.

Vous êtes propriétaire de l'API ou éditeur·trice d'une version de l'API.
  1. Dans la page d'accueil, allez à l'API pour laquelle vous souhaitez créer une nouvelle version.
    Vous pouvez filtrer la liste par nom ou propriétaire, si besoin.
  2. Ouvrez la dernière version pour afficher l'Aperçu, puis cliquez sur Créer une nouvelle version.
    Vue d'API Contracts et du bouton Créer une nouvelle version.
  3. Ouvrez la nouvelle version.
  4. Cliquez sur Create (Créer).
Une nouvelle version de votre API est créée, avec le même contenu que dans la dernière version. Les mocks et la documentation sont désactivés par défaut.

Publication d'une version d'API dans Qlik Catalog

Publiez une version d'un contrat d'API dans un espace Qlik afin que les collaborateurs puissent la trouver dans Qlik Catalog.

Vous êtes propriétaire de l'API ou éditeur·trice de la version d'API.

Lorsque vous publiez une version, la version du contrat devient immuable et en lecture seule dans API Contracts. Pour apporter des modifications, créez une nouvelle version à partir de la dernière version et continuez à travailler sur la nouvelle version.

  1. Sur la page d'accueil, cliquez sur la version que vous souhaitez publier pour ouvrir l'Aperçu, puis cliquez sur Publier.
    Vue d'API Contracts et du bouton Publier.
  2. Dans la boîte de dialogue de publication, sélectionnez l'espace Qlik dans lequel publier la version.
  3. Examinez l'aperçu de la version et saisissez une note de publication.
  4. Cliquez sur Publier.

La version sélectionnée est publiée dans l'espace Qlik de votre choix et passe en lecture seule dans API Contracts. Si vous devez modifier de nouveau le contrat, commencez par créer une nouvelle version.

Supprimer une version d'API

Vous êtes propriétaire de l'API.
  1. Sur la page d'accueil, cliquez sur le bouton Menu à côté de la version à supprimer, puis cliquez sur Delete (Supprimer).
  2. Cliquez sur Delete (Supprimer) pour confirmer.
La version sélectionnée est supprimée. Si vous souhaitez supprimer une API entière, vous devez supprimer chaque version.

Importer le contenu d'une version

Importez le contenu d'un contrat existant dans une version d'API, en remplaçant ou en fusionnant son contenu actuel.

Vous êtes propriétaire de l'API ou éditeur·trice de la version d'API.

Utilisez cette fonctionnalité pour mettre à jour une version à partir d'un fichier de contrat d'API sans créer de nouvelle version. L'identificateur de version est conservé tout au long de l'importation.

Cette opération est différente de Importer une définition, qui crée une nouvelle API dans API Contracts.

  1. Ouvrez Import version content (Importer le contenu de la version) de la version à mettre à jour.

    Cette action n'est pas disponible pour une version en lecture seule.

    Vous pouvez accéder à cette action depuis les emplacements suivants :

    • Sur la page d'accueil, cliquez sur Menu à côté de la version, puis sur Importer le contenu de la version.
      Option Import version content (Importer le contenu de la version) du bouton de menu.
    • Dans l'Aperçu de la version, cliquez sur Menu > Importer le contenu de la version.
      Vue détaillée de la version
    • Dans l'éditeur de version, cliquez sur Edit (Modifier) > Import version content (Importer le contenu de la version).
      Option Import version content (Importer le contenu de la version) de l'éditeur de version.
  2. Sélectionnez un format et une source pour le contrat à importer.
    Vous pouvez procéder à l'importation depuis un fichier local, une URL ou un texte que vous collez directement dans la boîte de dialogue.
  3. Sous Behavior (Comportement), sélectionnez le mode d'application du contenu importé.
    • Replace (Remplacer) : remplace l'ensemble du contenu actuel par le contrat importé. Le nom d'API, l'identificateur de version et la version de spécification sont conservés.
    • Merge (Fusionner) : combine le contenu importé avec le contenu de version existant. Le nom d'API et l'identificateur sont conservés. Si un élément importé porte le même nom qu'un élément existant, l'élément importé est renommé avec un suffixe _merge (par exemple, User_merge). Les URL de base et les types de médias en double sont ignorés.
    Boîte de dialogue Import version content (Importer le contenu de la version).
  4. Cliquez sur Import (Importer).

L'éditeur de version s'ouvre avec le contenu mis à jour appliqué.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici