# Detecteur de breaking changes API et planificateur de migration Compare deux schemas OpenAPI 3.x, identifie les breaking changes et suggere des plans de migration > Page canonique: https://elysiatools.com/fr/tools/api-breaking-changes-detector-migration-planner - **Catégorie:** Development - **Mots-clés:** openapi, breaking change, api diff, migration, schema ## Présentation Utile pour les equipes API avant release afin de mesurer les suppressions de champs et durcissements de contrat. ## Entrées - **Ancien schema OpenAPI** (textarea): openapi: 3.0.3 paths: /users: ... - **Nouveau schema OpenAPI** (textarea): openapi: 3.0.3 paths: /users: ... ## Quand l'utiliser - Avant de publier une nouvelle version majeure ou mineure de votre API pour vérifier la rétrocompatibilité. - Lors de la revue de code modifiant le contrat d'interface OpenAPI pour anticiper les impacts côté client. - Pour planifier la communication technique et rédiger les guides de migration destinés aux développeurs consommateurs de l'API. ## Fonctionnement - Collez le schéma OpenAPI 3.x de votre version actuelle dans le champ Ancien schéma OpenAPI. - Insérez le schéma de la nouvelle version dans le champ Nouveau schéma OpenAPI. - L'outil analyse les différences structurelles, comme les champs supprimés ou les paramètres devenus obligatoires. - Consultez le rapport HTML généré pour visualiser l'impact des changements et lire les suggestions de migration. ## Cas d'usage - Audit de rétrocompatibilité d'une API publique avant le déploiement en production. - Génération d'un changelog technique précis pour les équipes front-end ou les partenaires externes. - Détection préventive des erreurs de conception d'API lors des phases de spécification. ## Questions fréquentes ### Quels formats de schémas sont supportés ? L'outil prend en charge les spécifications au format OpenAPI 3.x, que ce soit en syntaxe YAML ou JSON. ### Qu'est-ce qui est considéré comme un breaking change ? Les modifications telles que la suppression d'un champ de réponse, l'ajout d'un paramètre de requête obligatoire ou le changement de type d'une donnée existante. ### L'outil modifie-t-il mes fichiers originaux ? Non, il effectue uniquement une comparaison en lecture seule des textes fournis et génère un rapport d'analyse. ### Puis-je utiliser cet outil pour des API REST classiques ? Oui, à condition que votre API soit documentée avec une spécification OpenAPI 3.x valide. ### Comment les résultats sont-ils présentés ? Les résultats sont affichés sous forme de rapport HTML, regroupant les changements par niveau d'impact avec des conseils de migration associés. ## Outils associés - [Testeur regex PCRE2](https://elysiatools.com/fr/tools/pcre-regex-tester): Testez les motifs PCRE2 en ligne : toutes les syntaxes de groupes nommés ((?P), (?), (?'n')), quantificateurs possessifs, groupes atomiques, \\A \\z \\h — plus pcre2grep et l’API C. - [Benchmark Regex](https://elysiatools.com/fr/tools/regex-benchmark): Comparez les performances de différents modèles regex, identifiez les goulots d'étranglement et détectez les cas dégénérés - [Aide-mémoire Regex](https://elysiatools.com/fr/tools/regex-cheat-sheet): Aide-mémoire consultable et localisé pour la syntaxe des expressions régulières — classes de caractères, ancres, quantificateurs, groupes et références, assertions, séquences d’échappement et indicateurs, avec un testeur rapide intégré - [Analyseur de PDF riches en formules et graphiques](https://elysiatools.com/fr/tools/formula-chart-heavy-pdf-analyzer): Compare lextraction locale et hybrid dOpenDataLoader afin didentifier les pages qui meritent une aide IA - [Rapport de conformité loudness podcast](https://elysiatools.com/fr/tools/audio-podcast-loudness-compliance-report): Compare LUFS intégré, true peak, LRA, stéréo/mono, débit et fréquence d'échantillonnage à Apple Podcasts, Spotify, YouTube, ACX et broadcast. - [Processeur de Valeurs Aberrantes](https://elysiatools.com/fr/tools/data-outlier-processor): Outil avancé de détection et traitement des valeurs aberrantes qui identifie, supprime ou remplace les valeurs anormales en utilisant plusieurs méthodes statistiques. - [Fusion de Brûlure de Couleur d'Image](https://elysiatools.com/fr/tools/image-color-burn): Applique le mode de fusion brûlure de couleur entre deux images pour un assombrissement dramatique et des effets de couleur intenses - [Fusion d'Éclaircissage de Couleur d'Image](https://elysiatools.com/fr/tools/image-color-dodge): Applique le mode de fusion éclaircissage de couleur entre deux images pour des effets brillants, éthérés et lumineux ## Exemples - [Collections Postman - Tests API](https://elysiatools.com/fr/samples/postman-collections): Exemples complets de collections Postman incluant tests API, scripts d'automatisation, variables d'environnement, serveurs mock et patterns de test avancés pour REST APIs - [Exemples OpenAI API](https://elysiatools.com/fr/samples/openai): Exemples complets de l'API OpenAI incluant les modèles GPT, la génération d'images DALL-E, le traitement audio Whisper et les appels de fonctions - [API Graphique WebGPU](https://elysiatools.com/fr/samples/webgpu): API graphique moderne pour les graphiques 3D haute performance et le calcul GPU dans le navigateur - [Échantillons Audio FLAC Libres de Droits](https://elysiatools.com/fr/samples/flac-samples): Collection audio FLAC sans perte pour tests et développement, incluant sons de la nature et musique de méditation ## Contenu associé - [Versionnage d API et revue des changements cassants](https://elysiatools.com/fr/hubs/api-versioning-breaking-change-review): Comparez les versions d API, planifiez la migration et acceptez la compatibilite avant la release. Les outils ne remplacent ni le deploiement reel ni la supervision. - [Définition de contrats API, validation de schémas et tests de changements](https://elysiatools.com/fr/hubs/api-contract-testing): Définissez un contrat API, validez schémas et charges capturées, détectez les risques de compatibilité et consignez l'acceptation. - [Workflow utilitaire OpenAPI](https://elysiatools.com/fr/hubs/openapi-utility): Generez types et documentation OpenAPI, verifiez les ruptures, validez les reponses et renforcez le contrat par stress et mutation tests. - [Outils de validation JSON Schema et de contrats API](https://elysiatools.com/fr/hubs/json-validate): Comparez la validation JSON Schema, les contrôles de réponse OpenAPI, les tests de mutation, les tests de charge contractuels et la détection de changements cassants dans un hub unique.