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

Minifier

Réduisez code et assets pour la production — minifiez JS, CSS, HTML, JSON, XML et SVG avant gzip ou déploiement CDN.

Beautifier

Rendez le code lisible avec une indentation cohérente — beautifiez JavaScript, CSS, TypeScript, SCSS, LESS, Markdown, GraphQL, SQL, YAML et plus encore dans votre navigateur.

Déminifier

Développez du code minifié ou compressé — déminifiez JavaScript, CSS, TypeScript, SCSS, LESS, SQL, YAML et d'autres formats pour déboguer ou relire.

Conversion

Transformez des données entre JSON, YAML, XML et CSV localement — sans envoi serveur.

Préprocesseurs CSS

Compilez SCSS ou LESS en CSS standard dans le navigateur — complétez avec beautify ou minify pour un workflow feuille de style complet.

Outils JSON

Validez, formatez, comparez et explorez des payloads JSON — complémentaires aux minificateurs et convertisseurs.

Outils SVG

Prévisualisez, optimisez avec SVGO, exportez en Data URI, redimensionnez, formatez, convertissez en JSX et validez vos SVG — tout dans le navigateur.

DevOps & Infra

Format/validate/minify HCL, format & lint Dockerfile, validation Compose et .env.

CI/CD

GitHub Actions et GitLab CI — formater le YAML et vérifier la structure des workflows/jobs dans le navigateur.

Logs & observabilité

JSON/NDJSON ligne à ligne et access logs Nginx/Apache — format, filtre, validation et CSV/TSV.

Kubernetes

Manifestes multi-docs, validation structurelle, starters Ingress/Deployment et formatage values Helm.

Réseau / IP

CIDR, sous-réseaux et helpers IPv4/IPv6 — dans le navigateur.

Sécurité & tokens

JWKS, certificats X.509 et scan de secrets — locaux navigateur.

Encodage

Encodez ou décodez Base64, composants URL et entités HTML — uniquement côté client.

Utilitaires développeur

Timestamps, UUID, ULID, Nanoid, cron, mots de passe, regex, slugify, bases, casse, diff texte et chmod — tout côté client.

Texte & Markdown

Comptez, générez un sommaire Markdown et nettoyez des listes de lignes — dans le navigateur.

Sérialisation

Sérialisez et désérialisez des structures PHP à côté de vos flux JSON.