Valider un document OpenAPI

Choisissez OpenAPI 3.0 ou 3.1 en JSON ou YAML, et nommez les fichiers de référence que vous fournissez.

  • Fonctionne dans votre navigateur
  • Aucun envoi
  • Vérifiez avant de télécharger

Choisissez OpenAPI 3.0 ou 3.1 en JSON ou YAML, et nommez les fichiers de référence que vous fournissez. Vérifiez les opérations, les cibles locales et les diagnostics de structure et d’objets Schema. Seul le dialecte OAS figé est pris en charge ; les formats sont des annotations, sans validation d’instances de données.

Méthode: OAS 3.0 (2024-10-18) / 3.1 (2025-09-15); $schema: OAS3.1 (2024-11-10)

Traitement local

Vos données restent dans le traitement local du navigateur, sans requête, sans stockage et sans télémétrie sur le contenu. Les sauvegardes d’originaux et les exports où vous avez révélé des secrets peuvent en contenir ; gardez-les en local.

Limites de ressources

Entrée totale ≤ 1 Mio ; texte ≤ 200 000 caractères (XML : 100 000) ; profondeur 32 et 20 000 nœuds par document ; 1 000 lignes ou opérations au maximum ; sortie ≤ 2 Mio ; délai de 5 s. Annuler arrête le traitement. Ces limites de l’application ne garantissent pas un plafond sur toute la mémoire du navigateur.

≤ 20 fichiers de référence fournis ; ≤ 1 000 références, chaîne de 32 au maximum. Les identifiants de ressources imbriquées sont des identifiants logiques locaux, jamais des chargements réseau. Les cibles de base et la syntaxe des références dynamiques sont vérifiées ; les liaisons dynamiques d’instances ne sont pas évaluées.

Source
Profil déclaré
Fichiers de référence fournis

Choisissez le profil et vérifiez les diagnostics avant d’utiliser le résultat enregistré. Modifier, réinitialiser ou quitter annule le travail et supprime l’aperçu. Enregistrez les sauvegardes des originaux séparément ; aucun fichier source n’est écrasé.

Copie originale: 1048576 B / Analyser / générer

Comment analyser ces données

  1. Source

    Chargez le document racine JSON ou YAML, choisissez le dialecte automatique ou explicitement OAS3.0/3.1, et fournissez les fichiers de référence locaux nommés. Les noms doivent correspondre aux chemins $ref relatifs.

  2. Profil déclaré

    Utilisez OAS3.1.0, un titre info Demo et une version 1, paths {} et components.schemas.Name.$ref = ./models.json. Fournissez models.json contenant {"type":"string"} pour résoudre ce schéma.

  3. Vérifier et enregistrer

    Examinez les diagnostics aux chemins du document et le graphe des références. Sans models.json, la référence reste non résolue ; fournissez-le et relancez avant d’enregistrer le rapport.

Questions sur le profil

Que signifie ce résultat ?

Les contrôles portent sur la structure du document et sur les règles d’objets de schéma prises en charge. Ils n’envoient aucune requête d’API et ne valident pas de vraies réponses par rapport au contrat.

Comment corriger une entrée refusée ou manquante ?

Un fichier nommé manquant reste non résolu ; les URL distantes ne sont jamais chargées. Corrigez l’orthographe, le format et le dialecte ; résoudre une référence ne garantit pas que le contenu est valide.

Quelles sont les limites de cet outil ?

Profils locaux finis d’OAS3.0/3.1, et non toutes les extensions ni tous les comportements de liaison dynamique d’instances. Le texte source et les références restent sur cet appareil.