Accéder au contenu principal Passer au contenu complémentaire

Utiliser plusieurs versions

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

Talend Cloud API Designer vous permet de conserver plusieurs versions du même contrat d'API lorsque vous préparez des modifications dans une nouvelle version.

  • Maintenir une version d'API existante en production tout en introduisant des modifications majeures dans une nouvelle version.
  • Suivez et gérez les versions d'API depuis un seul et même point.
  • Travaillez sur les modifications d'API sans affecter les versions existantes.

Lorsque vous créez une nouvelle version d'une API, tout le contenu est copié dans la nouvelle version. La dernière version peut ensuite être mise à jour indépendamment sans affecter les versions précédentes.

Seule la dernière version est modifiable, et vous pouvez créer une nouvelle version uniquement à partir d'elle. Les versions plus anciennes sont en lecture seule.

La page d'accueil de Talend Cloud API Designer affiche toutes les API que vous possédez et toutes les versions d'API partagées avec vous.
Talend Cloud API DesignerPage d'accueil de .

Créer une version d'API

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

Avant de commencer

Note InformationsRemarque : You can create a new version only from the latest version. Older versions are read-only and cannot be edited or used to create a new version.
Vous êtes propriétaire de l'API ou éditeur.trice de la dernière version de l'API.

Procédure

  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 la vue Preview (Aperçu), puis cliquez sur Create a new version (Créer une nouvelle version).
    Vue du bouton Create a new version (Créer une nouvelle version).
  3. Saisissez la nouvelle version.
  4. Cliquez sur Create (Créer).

Résultats

Une nouvelle version de votre API est créée, avec le même contenu que celui de la dernière version. Les mocks et la documentation sont désactivés par défaut.

Supprimer une version d'API

Avant de commencer

Vous êtes propriétaire de l'API.

Procédure

  1. Sur la page d'accueil, cliquez sur Menu à côté de la version à supprimer, puis sur Delete (Supprimer).
    Note InformationsRemarque : You cannot delete a version if its documentation is published on API Portal. You need to unpublish it or mark it as unpublished before deleting it. For more information, see Managing your API documentation.
  2. Cliquez sur Delete (Supprimer) pour confirmer.

Résultats

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.

Avant de commencer

Vous êtes propriétaire de l'API ou éditeur.trice de la dernière version de l'API. Les versions en lecture seule ne supportent pas cette action.

Pourquoi et quand exécuter cette tâche

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 l'opération Importing a definition (Importer une définition), qui crée une nouvelle API dans Talend Cloud API Designer.

Procédure

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

    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 Import version content (Importer le contenu de la version).
      Option Import version content (Importer le contenu de la version) du bouton de menu.
    • Sur la vue Preview (Aperçu), cliquez sur Menu, puis sur Import version content (Importer le contenu de la version).
      Option Import version content (Importer le contenu de la version) de la page d'accueil 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).

Résultats

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.