Convertisseur OpenAPI vers JSON Schema — Gratuit en ligne

Extrayez components.schemas OpenAPI 3.0–3.2 vers JSON Schema — Draft 2020-12 ($defs) par défaut, Draft-07 (definitions) en option. Local au navigateur, sans upload.

Chargement…
Documentation OpenAPI vers JSON Schema
Extraire components.schemas OpenAPI vers JSON Schema (2020-12 ou Draft-07).

Notes développeur

Schémas OpenAPI 3.0 via @openapi-contrib/openapi-schema-to-json-schema. OpenAPI 3.1 / 3.2 : strip best-effort des mots-clés OAS-only. Sortie défaut : $schema 2020-12 + $defs ; option Draft-07 ($schema + definitions + refs #/definitions). Conversion live au collage/échantillon ; Convertir explicite (⌘↵) ; entrée Monaco JSON/YAML + sortie Shiki JSON. components.schemas vide → erreur. $ref externes rejetés. Max 512 Kio.

Options

Draft cible
2020-12 (défaut) émet $schema + $defs. Draft-07 remap vers l’URI Draft-07, definitions à la place de $defs, et refs #/definitions/… — rename structurel uniquement ; les mots-clés propres à 2020-12 ne sont pas réécrits.

Cas d’usage

Réutiliser des modèles OpenAPI comme JSON Schema autonome. Alimenter le Validateur JSON Schema. Comparer des formes de schéma hors document OpenAPI complet.

Exemples

OpenAPI YAML → JSON Schema $defs

Avant

openapi: "3.0.3" info: title: Pets version: 1.0.0 paths: {} components: schemas: Foo: type: object properties: id: type: string Bar: type: object properties: name: type: string

Après

{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "Foo": { ... }, "Bar": { ... } } }

Schémas vides rejetés

Avant

openapi: "3.0.3" info: title: t version: "1" paths: {} components: schemas: {}

Après

Erreur : components.schemas vide

FAQ OpenAPI vers JSON Schema

Questions fréquentes

La conversion 3.1 est-elle identique au Draft-07 ?

Non. La conversion OpenAPI 3.1/3.2 est un strip best-effort. La sortie par défaut est Draft 2020-12 ($defs). Choisissez Draft-07 pour un remap structurel (definitions + $schema Draft-07) — pas une réécriture complète des mots-clés. Voir Options.

Et s’il n’y a pas de schéma Root ?

Tous les schémas vont sous $defs (ou definitions si Draft-07 est sélectionné), sans type/properties racine inventés. Un schéma nommé Root ajoute aussi un $ref racine vers cette entrée.

Outils liés ?

Sens inverse : JSON Schema vers OpenAPI ; valider la source : Valider OpenAPI.

API & schémas

Outils OpenAPI pour formater, valider et analyser vos specs.

Découvrez les autres catégories d'outils