Valider une spec OpenAPI 3 / Swagger en ligne avant la CI
Erreurs de schéma, $ref cassées, responses manquantes : validez votre contrat API OpenAPI 3.0–3.2 dans le navigateur.
Valider une spécification OpenAPI avant la fusion
Une spécification OpenAPI invalide bloque les générateurs de clients, fait échouer les imports de passerelle d'API et retarde les revues de contrat. Pourtant, les erreurs les plus courantes passent souvent inaperçues dans un diff YAML de plusieurs centaines de lignes. C'est le cas d'un champ info incomplet, d'une référence $ref interne cassée ou d'une version openapi non prise en charge. Le validateur OpenAPI en ligne de FastMinify vérifie la conformité au schéma OpenAPI 3.0, 3.1 et 3.2 via @scalar/openapi-parser, entièrement dans le navigateur. Collez du JSON ou du YAML : le verdict, les chemins d'erreur et les statistiques de la spécification s'affichent sans aucun envoi à un serveur. Complétez avec le formateur OpenAPI pour une relecture lisible, puis explorez le hub outils API. Si la syntaxe JSON brute est douteuse, commencez par le validateur JSON. Pour optimiser les payloads une fois le contrat validé, voir le guide d'optimisation des APIs REST.
#/… vérifiées, chemins d'erreur Scalar affichésLimites honnêtes et bonnes pratiques
Un verdict « valide » signifie une conformité au schéma OpenAPI, pas que votre API répond correctement en production.
$ref externes ni des URL distantesScalar vérifie les références #/. Les références HTTP(S) vers d'autres fichiers ne sont jamais résolues : la spécification doit être autonome pour une validation fiable dans le navigateur.
$ref externe non résolue peut passer l'analyse et échouer ailleursL'outil du navigateur accélère le retour avant le commit, et la CI reste la source de vérité pour les équipes.
git push : c'est plus rapide qu'un pipeline completCe que l'outil vérifie et refuse dans OpenAPI 3 et Swagger 2
OpenAPI 3.x décrit vos endpoints REST, les schémas de requête et de réponse, la sécurité et les composants réutilisables. FastMinify valide la conformité au méta-schéma OpenAPI, pas le comportement de votre API à l'exécution.
3.0.x, 3.1.x, 3.2.xopenapi, info.title, info.version, pathsschemas, responses et parameters, avec les références internes résoluesUn document dont la clé racine est swagger: "2.0" n'est pas pris en charge par cet outil. Le message d'erreur est explicite : ne tentez pas de le valider ici.
swagger ; OpenAPI 3 utilise openapiAu-delà de la syntaxe, ces écarts structurels font échouer la CI ou les générateurs de SDK.
$ref interne qui pointe vers un composant inexistant provoque un échec de validationdescription enfreint une règle OpenAPIoperationId dupliqué ou absent bloque certains générateurstype incompatible avec des nullable / oneOf mal imbriquésLe hub API propose trois intentions distinctes : ne les confondez pas pendant la relecture d'une PR.
Valider une spécification OpenAPI pas à pas
Le validateur OpenAPI analyse l'entrée (JSON ou YAML, 512 KiB au plus), puis appelle validate() de Scalar. Le résultat donne un statut, la première erreur avec sa ligne si elle est connue et la liste des problèmes avec leurs chemins JSON Pointer.
https://… ne sont jamais téléchargées, par limitation volontaireLe formateur OpenAPI réécrit le JSON ou le YAML avec une indentation de 2 ou 4 espaces et un tri des clés en option. Il aide la relecture humaine et ne remplace pas la validation.
Vous exportez une spécification depuis un outil de design et l'import dans AWS API Gateway ou Kong échoue sans explication.
Collez-la dans validate-openapi
Ouvrez validate-openapi. Si l'analyse échoue, corrigez d'abord la syntaxe JSON ou YAML : le validateur JSON peut aider sur les parties en JSON.
Correction des $ref internes
Les problèmes de Scalar indiquent le chemin (par exemple #/components/schemas/User manquant). Corrigez la faute de frappe ou ajoutez le composant référencé.
Formatez et faites le commit
Passez la spécification validée dans format-openapi, téléchargez-la et ouvrez la PR. Importez-la de nouveau dans la passerelle.
L'équipe mobile génère un client à partir de la spécification, et une erreur de schéma bloque tout le pipeline.
Validez la version fusionnée
Collez la spécification de la branche main dans validate-openapi. Un verdict invalide signifie qu'il faut bloquer le tag de version.
Vérifiez info et paths
Les champs info doivent être complets et chaque opération doit avoir des responses avec description. Les statistiques du panneau de résultats aident à repérer des chemins vides.
Minifiez les exemples JSON
Les exemples embarqués volumineux ralentissent les relectures : utilisez le minificateur JSON sur les payloads d'exemple une fois la spécification validée.
Conclusion
Valider une spécification OpenAPI avant la CI évite des heures de débogage sur des imports de passerelle ou des générateurs de SDK silencieux. Collez, validez, corrigez les chemins signalés par Scalar, le tout en local. Formatez pour la relecture, puis explorez le hub API pour le lint, la conversion JSON Schema et la validation GraphQL.
Validez votre spécification OpenAPI maintenant
Articles connexes
Collez un token et un JWKS pour vérifier une signature RS256, ES256 ou HS256 dans le navigateur. Choix par kid, erreurs mesurées, claims à contrôler.
HTTP/2 et HTTP/3 changent le trajet des fichiers, pas leur poids. Mesures de taille, de compilation et de bundling : ce que la minification apporte encore.
Convertissez un epoch Unix en date lisible et inversement, distinguez secondes et millisecondes, et évitez les pièges de fuseau, de JWT et de changement d’heure.