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.

Chargement…
Documentation Valider OpenAPI
Vérifiez la conformité schéma OpenAPI 3.x en local.

Notes développeur

Utilise @scalar/openapi-parser en import dynamique (validate uniquement). OpenAPI 3.0, 3.1 et 3.2. Validation live debounced ; entrée Monaco JSON/YAML auto-détectée. 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. Le panneau Résultats affiche verdict, chemins Scalar et stats spec.

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

{ "openapi": "3.1.0", "info": { "title": "Pets", "version": "1.0.0" }, "paths": { "/pets": { "get": { "operationId": "listPets", "tags": ["pets"], "summary": "List pets", "responses": { "200": { "description": "OK" } } } } } }

Après

Statut : valide

Swagger 2 rejeté

Avant

{"swagger":"2.0","info":{"title":"t","version":"1"},"paths":{}}

Après

Non supporté : Swagger 2.0

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.

API & schémas

Outils OpenAPI pour formater, valider et analyser vos specs.

Découvrez les autres catégories d'outils