Convertisseur JSON Schema vers OpenAPI — Gratuit en ligne

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

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é.

0 chars · 0 B

OpenAPI

Partager cet outil:

JSON Schema

Document OpenAPI

La conversion s’exécute dans votre 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. • $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é). • 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.

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.