Convertisseur OpenAPI vers JSON Schema — Gratuit en ligne

Q: 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.

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.

0 chars · 0 B

Draft

Partager cet outil:

Document OpenAPI

JSON Schema

La conversion s’exécute dans votre navigateur — rien n’est envoyé.

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). • 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.