# Validateur OpenAPI / Swagger Valide structurellement les documents OpenAPI 3.0/3.1 et Swagger 2.0 : champs requis, complétude des chemins/opérations, codes de réponse, résolution des $ref, unicité des operationId et intégrité des composants > Page canonique: https://elysiatools.com/fr/tools/openapi-validator - **Catégorie:** Validation - **Mots-clés:** openapi, swagger, valider, api, spec, rest ## Présentation Ce validateur OpenAPI et Swagger en ligne vous permet de vérifier instantanément la conformité structurelle de vos spécifications d'API REST pour les versions OpenAPI 3.0/3.1 et Swagger 2.0. Il analyse en profondeur la présence des champs requis, la résolution des références ($ref), l'unicité des identifiants d'opération (operationId) ainsi que la cohérence globale de vos composants et codes de réponse. ## Entrées - **Document OpenAPI / Swagger** (textarea): openapi: 3.0.3 info: title: Example API version: 1.0.0 paths: /users: get: summary: List users responses: '200': description: OK ## Quand l'utiliser - Avant de générer du code client ou serveur à partir d'un fichier de spécification OpenAPI pour éviter les erreurs de compilation. - Lors de la mise à jour d'une documentation d'API REST pour s'assurer que tous les schémas et codes de réponse sont correctement définis. - Pour déboguer des références circulaires ou des liens brisés ($ref) dans des fichiers de configuration Swagger volumineux. ## Fonctionnement - Collez votre document OpenAPI ou Swagger (au format YAML ou JSON) dans la zone de saisie de texte. - L'outil analyse la structure du document, résout les références $ref et vérifie la présence des champs obligatoires. - Le validateur contrôle l'unicité des operationId et la validité des codes de réponse HTTP déclarés. - Les résultats s'affichent sous forme de rapport détaillé mettant en évidence les erreurs de syntaxe et de conformité. ## Cas d'usage - Validation de schémas d'API avant leur intégration dans un pipeline de déploiement continu (CI/CD). - Audit rapide de fichiers Swagger tiers pour identifier les paramètres manquants ou les codes de réponse invalides. - Vérification de la conformité syntaxique lors de la rédaction manuelle de spécifications OpenAPI. ## Questions fréquentes ### Quelles versions d'OpenAPI sont prises en charge ? Le validateur prend en charge les spécifications OpenAPI 3.0, OpenAPI 3.1 ainsi que Swagger 2.0. ### L'outil prend-il en charge les formats JSON et YAML ? Oui, vous pouvez coller vos spécifications d'API indifféremment au format JSON ou YAML. ### Comment sont gérées les références $ref ? L'outil résout et valide l'intégrité des références $ref pour s'assurer qu'elles pointent vers des composants existants. ### Pourquoi l'unicité des operationId est-elle importante ? Des operationId uniques évitent les conflits lors de la génération automatique de SDK ou de documentation interactive. ### Mes données d'API sont-elles conservées sur vos serveurs ? Non, la validation est effectuée localement ou de manière éphémère sans stockage persistant de vos spécifications. ## Outils associés - [Validateur de Codes Postaux Mondiaux](https://elysiatools.com/fr/tools/global-postal-code-validator): Valide les formats de codes postaux de plusieurs pays, y compris les USA ZIP, le Royaume-Uni, le Canada et plus - [IBAN & SWIFT Validator](https://elysiatools.com/fr/tools/iban-swift-validator): Validate International Bank Account Number (IBAN) and SWIFT/BIC codes with checksum verification - [Calculateur de somme de contrôle Mod-11](https://elysiatools.com/fr/tools/mod11-checksum): Valide ou génère des nombres avec l'algorithme Modulus-11 (ISO 7064) du chiffre de contrôle, schémas ISBN-10 (10..2), ID norvégienne (3,7,6,1,8,9,4,5,2) et générique 2-7. - [Validateur de Codes Postaux des États-Unis](https://elysiatools.com/fr/tools/us-zip-code-validator): Valide les codes postaux américains, y compris les formats standard à 5 chiffres et ZIP+4 - [Validateur de Devise](https://elysiatools.com/fr/tools/currency-validator): Valide les codes de devise ISO 4217 - [Validateur d'Email](https://elysiatools.com/fr/tools/email-validator): Valide les adresses email et vérifie la délivrabilité - [Validateur de Fichiers .env](https://elysiatools.com/fr/tools/env-file-validator): Valider les fichiers .env pour les erreurs de syntaxe et problèmes courants - [Validateur Mondial de Numéros de Téléphone](https://elysiatools.com/fr/tools/global-phone-validator): Valide les numéros de téléphone de plusieurs pays dont la Chine, les États-Unis et plus ## 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é - [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.