# Detecteur de rupture OpenAPI diff Compare des schemas OpenAPI ou GraphQL, signale les breaking changes et genere un rapport dimpact pour les equipes API > Page canonique: https://elysiatools.com/fr/tools/openapi-diff-breach-detector - **Catégorie:** Development - **Mots-clés:** openapi, graphql, diff, breaking changes, schema, api ## Présentation Ce détecteur de rupture OpenAPI et GraphQL compare deux versions de vos schémas d'API pour identifier instantanément les changements incompatibles (breaking changes). Conçu pour les équipes de développement, il analyse vos spécifications, signale les champs supprimés ou les nouveaux paramètres obligatoires, et génère un rapport d'impact détaillé pour sécuriser vos mises en production. ## Entrées - **Schema precedente** (textarea): Paste the previous OpenAPI YAML/JSON or GraphQL SDL here... - **Nouveau schema** (textarea): Paste the updated OpenAPI YAML/JSON or GraphQL SDL here... - **Type de schema** (select) - **Format dentree** (text) - **Inclure lanalyse dimpact** (checkbox) ## Quand l'utiliser - Avant de fusionner une pull request modifiant le contrat d'une API publique ou interne. - Lors de la mise à jour de la documentation OpenAPI pour s'assurer qu'aucune régression n'a été introduite. - Pour auditer l'évolution d'un schéma GraphQL et prévenir les équipes clientes des changements à venir. ## Fonctionnement - Collez la version précédente de votre schéma OpenAPI (YAML/JSON) ou GraphQL SDL dans le champ 'Schéma précédent'. - Insérez la nouvelle version mise à jour dans le champ 'Nouveau schéma'. - Sélectionnez le type de schéma (OpenAPI ou GraphQL) et activez l'analyse d'impact si nécessaire. - L'outil compare les deux contrats et génère un rapport JSON listant les ruptures de compatibilité et le niveau de risque. ## Cas d'usage - Vérification manuelle rapide des contrats d'API avant d'automatiser les tests de non-régression dans une pipeline CI/CD. - Validation par les architectes logiciels des modifications apportées aux endpoints critiques lors des revues de code. - Génération d'un rapport clair pour informer les développeurs front-end ou mobiles des ajustements nécessaires côté client. ## Questions fréquentes ### Quels formats de schémas sont supportés ? L'outil prend en charge les spécifications OpenAPI (Swagger) au format YAML ou JSON, ainsi que les schémas GraphQL (SDL). ### Qu'est-ce qu'un 'breaking change' (changement incompatible) ? Il s'agit d'une modification qui risque de casser le code des clients existants, comme la suppression d'un champ de réponse ou l'ajout d'un paramètre requis. ### L'outil peut-il détecter le type de schéma automatiquement ? Oui, en laissant l'option 'Type de schéma' sur 'Auto detect', l'outil identifiera automatiquement s'il s'agit d'OpenAPI ou de GraphQL. ### Que contient le rapport d'impact ? Le rapport JSON inclut le niveau de risque global, un résumé des modifications, et le détail de chaque changement avec son chemin exact et son impact sur les clients. ### Mes schémas d'API sont-ils stockés ? Non, l'analyse est effectuée localement ou à la volée. Vos contrats d'API ne sont pas conservés. ## Outils associés - [Testeur de stress de contrat API](https://elysiatools.com/fr/tools/api-contract-stress-tester): Genere des tests de valeurs limites depuis OpenAPI 3.x et peut les envoyer a un backend reel pour reperer les ecarts de contrat. - [Sync de palette Tailwind](https://elysiatools.com/fr/tools/tailwind-color-palette-sync): Entrez des HEX, choisissez le schéma de noms (échelle 50–950 / nom unique / imbrication) et générez le fragment theme.extend.colors de tailwind.config.ts avec les niveaux WCAG AA/AAA. Dark mode optionnel. - [Explorateur d’Expressions Cron](https://elysiatools.com/fr/tools/cron-expression-explainer): Analyse une expression cron (5/6 champs ou Quartz) en description en langage naturel, détaille les champs et liste les N prochaines exécutions dans tout fuseau IANA, avec une explication IA - [Generateur de layout masonry CSS](https://elysiatools.com/fr/tools/css-masonry-layout-generator): Genere des layouts masonry en pur CSS avec breakpoints, espacements et selecteurs ignores - [Convertisseur cURL vers Go (net/http)](https://elysiatools.com/fr/tools/curl-to-go): Convertit une commande cURL en un extrait de code Go net/http avec http.NewRequest, en-têtes et corps - [Convertisseur cURL vers JavaScript (axios)](https://elysiatools.com/fr/tools/curl-to-js-axios): Convertit une commande cURL en un extrait de code JavaScript axios avec objet de config, en-têtes et données - [Convertisseur cURL vers JavaScript (fetch)](https://elysiatools.com/fr/tools/curl-to-js-fetch): Convertit une commande cURL en un extrait de code JavaScript fetch() avec en-têtes, corps et méthode - [Convertisseur cURL vers PHP (cURL)](https://elysiatools.com/fr/tools/curl-to-php): Convertit une commande cURL en un extrait de code PHP cURL avec curl_setopt, en-têtes et champs POST ## Exemples - [Exemples OpenAPI/Swagger](https://elysiatools.com/fr/samples/openapi): Exemples de spécification OpenAPI/Swagger pour la documentation d'API REST et la définition de contrats - [Exemples OpenAPI/Swagger](https://elysiatools.com/fr/samples/openapi-swagger): Exemples complets de documentation API utilisant OpenAPI 3.0 et les spécifications Swagger pour les services RESTful - [Exemples de Traitement d'Images Android Java](https://elysiatools.com/fr/samples/android-image-processing-java): Exemples de traitement d'images Android Java incluant lecture/écriture, mise à l'échelle et conversion de format - [Exemples de Traitement d'Images Android Kotlin](https://elysiatools.com/fr/samples/android-image-processing-kotlin): Exemples de traitement d'images Android Kotlin incluant lecture/écriture, mise à l'échelle et conversion de format ## Contenu associé - [Outils OpenAPI pour documentation, génération de code et revue de contrat](https://elysiatools.com/fr/hubs/openapi-utility): Comparez génération de code OpenAPI, documentation API, diff de schémas, validation de réponses et tests de contrat dans un hub unique pour la conception et la maintenance d’API. - [Outils de test de contrats API, de mock et de revue de schémas](https://elysiatools.com/fr/hubs/api-contract-testing): Générez des types et de la documentation depuis OpenAPI, créez des mocks, validez des réponses réelles et passez en revue les changements de schéma risqués dans un seul hub. - [Outils de versionnage d API, changements cassants et revue de mise en production](https://elysiatools.com/fr/hubs/api-versioning-breaking-change-review): Comparez les versions d API, detectez les changements cassants de schema, validez la compatibilite reelle des reponses et revoyez semver et changelog dans un hub cible. - [Outils de Diff et de Comparaison de Fichiers et de Données](https://elysiatools.com/fr/hubs/file-data-diff-comparison-tools): Comparez deux fichiers, payloads, schémas ou jeux de données côte à côte et mettez en évidence ce qui a changé : texte, JSON, CSV/Excel, PDF, images, audio, bases de données, API et configurations.