# Validateur de contrat de reponse API Valide une reponse JSON reelle contre le schema de reponse defini dans OpenAPI 3.x > Page canonique: https://elysiatools.com/fr/tools/api-response-contract-validator - **Catégorie:** Development - **Mots-clés:** openapi, api, reponse, schema, contrat ## Présentation Collez un document OpenAPI 3.x et une reponse API reelle, puis indiquez le path, la methode et le code HTTP. Loutil resolve le schema de reponse correspondant et signale les champs manquants, erreurs de type, enums invalides et champs non documentes. Mode demploi : - Spec OpenAPI : collez YAML ou JSON - JSON de reponse : collez la charge reelle - Chemin / Methode / Code HTTP : identifiez loperation et la reponse - Format du spec : gardez auto si besoin - Interdire les champs en trop : avertit sur les champs hors schema ## Entrées - **Spec OpenAPI** (textarea): openapi: 3.0.3 paths: /users/{id}: ... - **JSON de reponse** (textarea): {"id":1,"name":"Alice"} - **Chemin** (text): /users/123 - **Methode** (select) - **Code HTTP** (text): 200 - **Format du spec** (select) - **Interdire les champs en trop** (checkbox) ## Quand l'utiliser - Lors du développement d'une nouvelle route API pour s'assurer que la réponse correspond exactement à la spécification OpenAPI. - Pour déboguer des erreurs d'intégration entre le frontend et le backend liées à des types de données inattendus ou modifiés. - Lors de l'évaluation d'une API tierce pour vérifier si ses réponses réelles respectent sa documentation officielle. ## Fonctionnement - Collez votre spécification OpenAPI 3.x (au format YAML ou JSON) et la réponse JSON réelle renvoyée par votre API. - Indiquez le chemin (path), la méthode HTTP (GET, POST, etc.) et le code de statut (ex: 200) correspondant à l'opération à valider. - Cochez l'option pour interdire les champs en trop si vous souhaitez une validation stricte du schéma. - Consultez le rapport généré pour identifier les erreurs de type, les champs manquants ou les propriétés non documentées. ## Cas d'usage - Validation de contrats pilotée par le consommateur (Consumer-Driven Contract Testing). - Audit de conformité de la documentation d'une API existante. - Vérification stricte des charges utiles (payloads) lors de la mise à jour d'un endpoint critique. ## Questions fréquentes ### Quels formats de spécification sont supportés ? L'outil prend en charge les spécifications OpenAPI 3.x aux formats YAML et JSON. Le format peut être détecté automatiquement ou forcé manuellement. ### Que fait l'option 'Interdire les champs en trop' ? Cette option déclenche un avertissement si la réponse JSON contient des propriétés qui ne sont pas explicitement définies dans le schéma OpenAPI (équivalent à additionalProperties: false). ### Puis-je valider des codes d'erreur HTTP comme 400 ou 500 ? Oui, il suffit de renseigner le code HTTP correspondant (par exemple 400 ou 404) dans le champ dédié pour valider le schéma de la réponse d'erreur. ### L'outil supporte-t-il Swagger 2.0 ? Non, ce validateur est spécifiquement conçu pour résoudre et valider les schémas de réponse définis dans la norme OpenAPI 3.x. ### Comment l'outil gère-t-il les chemins avec des paramètres ? Vous devez saisir le chemin tel qu'il est défini dans votre spécification OpenAPI, par exemple /users/{id}, pour que l'outil puisse faire la correspondance. ## Outils associés - [Generateur de JSON Schema](https://elysiatools.com/fr/tools/json-schema-generator): Infere un JSON Schema a partir dun exemple JSON avec ajustement manuel et validation - [Pont PDF (OCR) vers JSON structuré](https://elysiatools.com/fr/tools/ocr-pdf-to-structured-json-bridge): Extrait la couche texte du PDF avec la géométrie (lignes par position y, tableaux par écarts de colonnes, titres par taille de police, paires clé-valeur à deux-points) puis remplit champ par champ un JSON Schema fourni — libellés appariés par clés normalisées, valeurs coercées vers les types déclarés et validées par ajv. - [Constructeur lien court + UTM + QR](https://elysiatools.com/fr/tools/short-url-utm-builder-qr-bundle): Une seule passe remplace le trio bit.ly + Campaign Builder + générateur de QR : saisissez la page de destination et les UTM (trio obligatoire GA4 validé, minuscules optionnelles) et obtenez l'URL complète tracée ; un slug base62 déterministe (hachage FNV-1a, même entrée → même slug, sans compte ni réseau) sur votre domaine court ; deux QR codes PNG (lien court et complet) ; plus les redirections nginx / vercel.json / Netlify et la ligne CSV de suivi de campagne. - [Découpage train/test stratifié](https://elysiatools.com/fr/tools/train-test-split-with-stratification): Lit un jeu de données CSV/JSON et le découpe en train/validation/test avec échantillonnage stratifié par la colonne cible (70/15/15 par défaut, graine reproductible), ou k-fold stratifié ; rapport de distribution des classes par split avec barres d'écart, contrôle des fuites par lignes dupliquées, aperçu SMOTE (interpolation des plus proches voisins sur le train) et export des CSV en ZIP. - [Validateur JSON Schema](https://elysiatools.com/fr/tools/json-schema-validator): Valide les données JSON par rapport à un JSON Schema pour vérifier la structure et les types de données - [REPL JSONPath interactif](https://elysiatools.com/fr/tools/jsonpath-repl-playground): Un REPL interactif JSONPath qui exécute des pipelines de requête multi-étapes sur n’importe quel JSON. Écrivez une expression JSONPath par ligne (ex. $..book\[?(@.price<10)\] puis $\[0:5\]) et voyez les correspondances de chaque étape avec comptes, chemins et valeurs — plus une URL partageable codant vos données et pipeline. Supporte la descente récursive ($..), les jokers (\[*\]), les filtres (\[?(@.price<10)\]), les slices (\[0:5:2\]) et les index négatifs. - [OpenAPI vers Postman Collection](https://elysiatools.com/fr/tools/openapi-to-postman-collection): Convertit une spec OpenAPI 3.x ou Swagger 2.0 (JSON/YAML) en Postman Collection v2.1.0 importable avec dossiers, variables, auth et réponses d'exemple. - [Generateur OpenAPI vers TypeScript](https://elysiatools.com/fr/tools/openapi-to-typescript-generator): Convertit des specifications OpenAPI ou Swagger JSON/YAML en types TypeScript, parametres de requete et modeles de reponse avec format et style de nommage configurables ## 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 AWS EventBridge](https://elysiatools.com/fr/samples/eventbridge-samples): Exemples AWS EventBridge incluant les bus d'événements, règles, cibles, registre de schémas, événements personnalisés et routage d'événements inter-comptes pour l'architecture serverless event-driven - [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 Traçage Distribué](https://elysiatools.com/fr/samples/distributed-tracing-samples): Exemples complets de traçage distribué utilisant Jaeger, OpenTelemetry et outils d'observabilité modernes ## Contenu associé - [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. - [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. - [Outils JSON d'inspection, d'utilite et de transformation](https://elysiatools.com/fr/hubs/json-utility): Formatez, inspectez, comparez, fusionnez, transformez, validez, analysez et marquez des charges JSON pour les API et donnees. - [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.