Validateur OpenAPI en ligne — Conformité du schéma
Vérifiez la conformité schéma OpenAPI 3.0–3.2 en local. JSON et YAML — les $ref externes ne sont jamais récupérés.
Notes développeur
• Utilise @scalar/openapi-parser en import dynamique (validate uniquement). • OpenAPI 3.0, 3.1 et 3.2. • Les $ref externes / URL ne sont jamais récupérés. • Les références internes #/… sont vérifiées par Scalar (réf. cassée = échec). • Swagger 2.0 est rejeté avec un message clair. • Limite 512 Kio.
Cas d’usage
• Détecter info manquant, versions invalides et erreurs de schéma avant la CI. • Coller une spec mono-fichier (JSON ou YAML) pour un contrôle local. • Vérifier que les cibles $ref internes existent.
Exemples
Spec minimale valide
Avant
Après
Swagger 2 rejeté
Avant
Après
FAQ Valider OpenAPI
Questions fréquentes
Que vérifie la validation ?
La conformité schéma OpenAPI 3.0–3.2 via @scalar/openapi-parser. Ce n’est pas un linter de style — utilisez Linter OpenAPI pour cela.
Les $ref sont-ils supportés ?
Les $ref externes / URL ne sont jamais récupérés. Les références internes #/… sont vérifiées : une cible manquante fait échouer la validation.
Swagger 2.0 est-il supporté ?
Non. Les documents avec une clé swagger sont rejetés. Ces pages ne promettent pas de validation Swagger.
JSON et YAML ?
Les deux. Auto-détection avec strip BOM ; si un document {…} échoue en JSON, un fallback YAML flow est tenté.
Outils liés ?
Voir aussi Validateur JSON, Beautify YAML et le hub outils API.
Outils OpenAPI du cluster
Convertisseurs, encodeurs, formateurs et minificateurs au même endroit ? Outils développeurs Ouvrez le catalogue des outils développeurs.