← Accueil des outils100 % côté client

Convertisseur GraphQL SDL vers JSON Schema & OpenAPI

Convertissez directement les définitions de schémas GraphQL SDL, types, requêtes et mutations en schémas JSON Schema Draft-07 et composants OpenAPI standard.

Spécification cible:

Inclure les docstrings de champAppliquer des champs non nulles stricts

Entrée GraphQL SDL47 lines

Sortie du schéma généré

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "GraphQLConvertedSchema",
  "type": "object",
  "definitions": {
    "User": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "username": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "bio": {
          "type": [
            "string",
            "null"
          ]
        },
        "isActive": {
          "type": "boolean"
        },
        "role": {
          "$ref": "#/definitions/UserRole"
        },
        "posts": {
          "type": "array",
          "items": {
            "$ref": "#/definitions/Post"
          }
        },
        "createdAt": {
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "id",
        "username",
        "email",
        "isActive",
        "role",
        "posts",
        "createdAt"
      ],
      "description": "User account definition with profile details"
    },
    "UserRole": {
      "type": "string",
      "enum": [
        "ADMIN",
        "EDITOR",
        "SUBSCRIBER",
        "GUEST"
      ],
      "description": "System role access level"
    },
    "Post": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "content": {
          "type": "string"
        },
        "published": {
          "type": "boolean"
        },
        "author": {
          "$ref": "#/definitions/User"
        },
        "tags": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          }
        },
        "viewCount": {
          "type": "integer"
        },
        "rating": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "title",
        "content",
        "published",
        "author",
        "viewCount"
      ],
      "description": "Blog publication entity"
    },
    "CreatePostInput": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string"
        },
        "content": {
          "type": "string"
        },
        "tags": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          }
        },
        "published": {
          "type": [
            "boolean",
            "null"
          ]
        }
      },
      "required": [
        "title",
        "content"
      ]
    },
    "SearchResult": {
      "anyOf": [
        {
          "$ref": "#/definitions/User"
        },
        {
          "$ref": "#/definitions/Post"
        }
      ]
    }
  }
}

Types analysés

5definitions

Champs convertis

20attributes

Taille du schéma

JSON Schema Draft-07

Référence technique et guide d'architecture

Convertisseur GraphQL SDL vers JSON Schema & OpenAPI — Guide de référence

Convertissez directement les définitions de schémas GraphQL SDL, types, requêtes et mutations en schémas JSON Schema Draft-07 et composants OpenAPI standard.

Paramètres clés et contrôles

schemaSdlstring

Le texte source brut en GraphQL Schema Definition Language (SDL) définissant les types, inputs, enums, unions, requêtes et mutations.

targetFormatstring

Format de spécification du schéma cible en sortie, tel que 'json-schema-draft-07', 'json-schema-2020-12', 'openapi-3.0' ou 'openapi-3.1'.

includeDirectivesboolean

Indique s'il faut traduire les directives GraphQL SDL personnalisées (ex. @deprecated, @description, règles de validation) en mots-clés de schéma standard ou en extensions comme 'x-graphql-directives'.

nullableFieldsStrategystring

Stratégie de gestion des champs GraphQL 'nullable' par rapport aux types Non-Null ('!'), avec un mappage vers 'type': ['string', 'null'] en JSON Schema ou 'nullable: true' en OpenAPI.

Conseils de pro et bonnes practices

Pièges courants et dépannage

SyntaxError: Unexpected character / Unknown type lors de l'analyse du SDL

Validez le SDL par rapport aux spécifications grammaticales officielles de GraphQL avant la conversion. Assurez-vous que tous les scalaires personnalisés (ex. DateTime, JSON, UUID) sont explicitement déclarés avec 'scalar NomDuScalaire' dans le SDL.

Erreurs de référence cyclique ou dépassement de pile d'appels récursifs lors de la génération du schéma

Désactivez la récursivité des schémas inline et activez la génération basée sur les références avec des identifiants racine '#/components/schemas' ou '#/definitions' afin que les structures circulaires soient résolues via des pointeurs JSON.

Échecs de validation OpenAPI 3.0 causés par les constructions 'type: ["string", "null"]'

Définissez explicitement le format cible sur OpenAPI 3.0 pour utiliser la combinaison 'type: string' avec 'nullable: true', car les tableaux multi-types ne sont pas supportés avant OpenAPI 3.1 et JSON Schema Draft-2020-12.

Foire aux questions (FAQ)

▼

Outils et utilitaires connexes

Tous les outils →

Syntaxe Crontab & Expressions Quartz Cheat Sheetdeveloper

Référence exhaustive de la syntaxe cron POSIX à 5 champs et Quartz à 6 champs. Raccourcis macros, calcul des cycles et prévention des chevauchements de tâches.

Ouvrir l'outil→

Guide Pratique des Expressions Régulières (RegEx) JavaScriptdeveloper

Manuel technique des expressions régulières ECMAScript, groupes de capture, remplacements et drapeaux de configuration.

Ouvrir l'outil→

Encodeur et Décodeur d'URLdeveloper

Encodez et décodez en toute sécurité des URL et paramètres de requête avec les normes RFC 3986, encodeURIComponent, encodeURI et formUrlEncoded.

Ouvrir l'outil→

Encodeur et Décodeur d'Entités HTMLdeveloper

Convertissez du texte et du code en entités HTML nommées, décimales et hexadécimales pour neutraliser les failles XSS et préserver les caractères spéciaux.

Ouvrir l'outil→

Timestamp Unix & Convertisseur d'Époque Cheat Sheetdeveloper

Référentiel du temps POSIX : conversion en secondes, millisecondes, microsecondes et nanosecondes, calculs de fuseaux et norme ISO 8601.

Ouvrir l'outil→

Calculateur de Permissions Chmod & Générateur de Commandesdeveloper

Calculateur visuel de permissions Linux et Unix. Convertissez facilement les modes octaux et notations symboliques (rwxr-xr-x) en commandes chmod.

Ouvrir l'outil→