← Inicio de herramientas100% del lado del cliente

Conversor de GraphQL SDL a JSON Schema y OpenAPI

Convierte definiciones de esquemas, tipos, queries y mutations en GraphQL SDL directamente a esquemas estándar de JSON Schema Draft-07 y componentes de OpenAPI.

Especificación de destino:

Incluir docstrings de camposForzar campos estrictamente no nulos

Entrada GraphQL SDL47 lines

Salida del esquema generado

{
  "$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"
        }
      ]
    }
  }
}

Tipos analizados

5definitions

Campos convertidos

20attributes

Tamaño del esquema

JSON Schema Draft-07

Referencia técnica y guía de arquitectura

Conversor de GraphQL SDL a JSON Schema y OpenAPI — Guía de referencia

Convierte definiciones de esquemas, tipos, queries y mutations en GraphQL SDL directamente a esquemas estándar de JSON Schema Draft-07 y componentes de OpenAPI.

Parámetros clave y controles

schemaSdlstring

Texto fuente en GraphQL Schema Definition Language (SDL) que define types, inputs, enums, unions, queries y mutations.

targetFormatstring

Formato de especificación de esquema de salida objetivo, como 'json-schema-draft-07', 'json-schema-2020-12', 'openapi-3.0' u 'openapi-3.1'.

includeDirectivesboolean

Indica si se deben traducir directivas personalizadas de GraphQL SDL (p. ej., @deprecated, @description, reglas de validación) a palabras clave estándar del esquema o extensiones como 'x-graphql-directives'.

nullableFieldsStrategystring

Estrategia de manejo para campos anulables de GraphQL frente a tipos no nulos ('!'), mapeando a 'type': ['string', 'null'] en JSON Schema o a 'nullable: true' en OpenAPI.

Consejos profesionales y mejores prácticas

Errores comunes y solución de problemas

SyntaxError: Unexpected character / Unknown type durante el parseo de SDL

Valida el SDL frente a las especificaciones gramaticales estándar de GraphQL antes de la conversión. Asegúrate de que todos los escalares personalizados (p. ej., DateTime, JSON, UUID) estén declarados explícitamente con 'scalar NombreEscalar' en el SDL.

Errores de referencia circular o desbordamiento de pila (call stack crash) durante la generación del esquema

Desactiva la recursión inline de esquemas y habilita la generación basada en referencias con identificadores raíz en '#/components/schemas' o '#/definitions' para que las estructuras circulares se resuelvan mediante punteros JSON.

Fallos de validación en OpenAPI 3.0 causados por construcciones 'type: ["string", "null"]'

Configura el formato de destino explícitamente en OpenAPI 3.0 para utilizar 'type: string' junto con 'nullable: true', ya que los arreglos multitipo no son compatibles antes de OpenAPI 3.1 y JSON Schema Draft-2020-12.

Preguntas frecuentes (FAQ)

▼

Herramientas y utilidades relacionadas

Todas las herramientas →

Sintaxis Crontab y Expresiones Quartz Cheat Sheetdeveloper

Guía definitiva de sintaxis cron POSIX de 5 campos y formato Quartz de 6 campos. Macros, cálculo de ciclos de ejecución y prevención de ejecuciones simultáneas.

Abrir herramienta→

Guía Técnica de Expresiones Regulares (RegEx)developer

Manual técnico de sintaxis ECMAScript RegExp, grupos de captura, aserciones lookahead/lookbehind y tokens de sustitución.

Abrir herramienta→

Codificador y Decodificador de URLdeveloper

Codifique y decodifique URLs y parámetros de búsqueda de forma segura con RFC 3986, encodeURIComponent, encodeURI y formUrlEncoded.

Abrir herramienta→

Codificador y Decodificador de Entidades HTMLdeveloper

Convierta texto y código en entidades HTML con nombre, decimales y hexadecimales para prevenir ataques XSS y preservar caracteres especiales.

Abrir herramienta→

Marca de Tiempo Unix y Conversor Epoch Cheat Sheetdeveloper

Manual de referencia de tiempo POSIX: conversión de segundos, milisegundos, microsegundos y nanosegundos, zonas horarias y formato ISO 8601.

Abrir herramienta→

Calculadora de Permisos Chmod y Generador de Comandosdeveloper

Calculadora visual de permisos de archivos Linux y Unix. Convierta valores octales y notación simbólica (rwxr-xr-x) en comandos chmod al instante.

Abrir herramienta→