Convertisseur JSON Schema vers OpenAPI — Gratuit en ligne

Convertissez un JSON Schema (Draft-07 / 2020-12) en document OpenAPI minimal — choisissez openapi 3.0.3 ou 3.1.0 (champ version ; les Schema Objects restent orientés OAS 3.0). 100 % dans le navigateur, rien n’est envoyé.

Chargement…
Documentation JSON Schema vers OpenAPI
Convertir un JSON Schema en document OpenAPI minimal (champ openapi 3.0.3 ou 3.1.0).

Notes développeur

Convertit JSON Schema Draft-07 / 2020-12 vers des objets schéma OpenAPI via @openapi-contrib/json-schema-to-openapi-schema. Sortie : document OpenAPI minimal (info, paths vides, components.schemas) avec openapi 3.0.3 (défaut) ou 3.1.0. Choix du format de sortie JSON (défaut) ou YAML — collez le résultat directement dans un fichier de spec OpenAPI existant. Conversion live au collage/échantillon ; Convertir explicite (⌘↵) pour édition manuelle ; entrée Monaco JSON + sortie Shiki. $defs / definitions deviennent des schémas nommés ; un schéma racine seul devient Root (ou title). Les $ref externes / http(s) sont rejetés — jamais téléchargés. Entrée JSON uniquement (YAML rejeté) — seul le format de sortie est au choix. Max 512 Kio.

Options

Version OpenAPI
Champ openapi du document : 3.0.3 (défaut) ou 3.1.0. Les objets schéma restent issus du convertisseur orienté OAS 3.0 (ex. nullable) ; choisissez 3.1.0 si votre toolchain attend cette chaîne de version.
Format de sortie
Choisissez JSON (défaut) ou YAML pour le document OpenAPI généré. OpenAPI accepte les deux sérialisations — préférez YAML pour coller le résultat dans un fichier de spec existant en YAML, ou JSON pour l’outillage qui attend du JSON.

Cas d’usage

Transformer un modèle JSON Schema en amorce components.schemas OpenAPI. Enchaîner avec Valider OpenAPI après conversion. Partager un stub OpenAPI mono-fichier depuis un schéma existant.

Exemples

JSON Schema $defs → OpenAPI components.schemas

Avant

{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "Pet": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "integer" }, "name": { "type": "string" } } } } }

Après

{ "openapi": "3.0.3", "info": { "title": "Converted from JSON Schema", "version": "1.0.0" }, "paths": {}, "components": { "schemas": { "Pet": { ... } } } }

$ref externe rejeté

Avant

{ "$ref": "https://example.com/schemas/pet.json" }

Après

Erreur : $ref externe non supporté

FAQ JSON Schema vers OpenAPI

Questions fréquentes

Quelle version OpenAPI est produite ?

Choisissez 3.0.3 (défaut) ou 3.1.0 dans la barre d’outils. Cela fixe le champ openapi du document. Les Schema Objects restent issus du convertisseur orienté OAS 3.0 (ex. nullable) — pas une réécriture complète OAS 3.1. Voir Options.

Les $ref externes sont-ils supportés ?

Non. Les $ref externes et http(s) provoquent une erreur dure. Seules les références internes #/… du document collé sont autorisées.

Puis-je coller du YAML ?

Non côté JSON Schema — JSON uniquement. Le YAML OpenAPI est supporté sur le convertisseur inverse et les outils OpenAPI. Le document OpenAPI généré, lui, peut être en JSON ou en YAML — choisissez via l’option Format de sortie de la barre d’outils.

Outils liés ?

Sens inverse : OpenAPI vers JSON Schema ; valider des données : Validateur JSON Schema ; syntaxe JSON seule : Validateur JSON.

API & schémas

Outils OpenAPI pour formater, valider et analyser vos specs.

Découvrez les autres catégories d'outils