← Início de ferramentas100% no lado do cliente

Conversor de GraphQL SDL para JSON Schema e OpenAPI

Converta definições de esquemas GraphQL SDL, tipos, queries e mutations diretamente em especificações padrão do JSON Schema Draft-07 e schemas de componentes do OpenAPI.

Especificação de destino:

Incluir docstrings dos camposImpor campos estritamente não nulos

Entrada GraphQL SDL47 lines

Saída do esquema gerado

{
  "$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 analisados

5definitions

Campos convertidos

20attributes

Tamanho do esquema

JSON Schema Draft-07

Referência técnica e guia de arquitetura

Conversor de GraphQL SDL para JSON Schema e OpenAPI — Guia de referência

Converta definições de esquemas GraphQL SDL, tipos, queries e mutations diretamente em especificações padrão do JSON Schema Draft-07 e schemas de componentes do OpenAPI.

Parâmetros principais e controles

schemaSdlstring

O texto-fonte bruto em GraphQL Schema Definition Language (SDL) contendo as definições de types, inputs, enums, unions, queries e mutations.

targetFormatstring

Formato da especificação de schema de saída pretendido, como 'json-schema-draft-07', 'json-schema-2020-12', 'openapi-3.0' ou 'openapi-3.1'.

includeDirectivesboolean

Indica se diretivas customizadas do GraphQL SDL (ex.: @deprecated, @description, regras de validação) devem ser convertidas em palavras-chave padrão do schema ou extensões como 'x-graphql-directives'.

nullableFieldsStrategystring

Estratégia de tratamento para campos anuláveis vs. tipos Non-Null ('!') do GraphQL, mapeando para 'type': ['string', 'null'] no JSON Schema ou 'nullable: true' no OpenAPI.

Dicas profissionais e melhores práticas

Problemas comuns e solução de problemas

SyntaxError: Unexpected character / Unknown type during SDL parsing

Valide o SDL contra a especificação formal da gramática GraphQL antes da conversão. Certifique-se de que todos os escalares customizados (ex.: DateTime, JSON, UUID) estejam declarados explicitamente com 'scalar NomeDoScalar' no SDL.

Erros de referência cíclica ou estouro de pilha (call stack overflow) durante a geração do schema

Desative a recursão inline de schemas e habilite a geração orientada a referências com identificadores raiz em '#/components/schemas' ou '#/definitions', garantindo que estruturas circulares sejam resolvidas via JSON pointers.

Falhas de validação no OpenAPI 3.0 causadas por construções 'type: ["string", "null"]'

Configure explicitamente o formato de destino para OpenAPI 3.0 para utilizar 'type: string' combinado com 'nullable: true', já que arrays com múltiplos tipos não são suportados em versões anteriores ao OpenAPI 3.1 e JSON Schema Draft-2020-12.

Perguntas frequentes (FAQ)

▼

Ferramentas e utilitários relacionados

Todas as ferramentas →

Sintaxe Crontab e Expressões Quartz Cheat Sheetdeveloper

Manual completo da sintaxe cron POSIX de 5 campos e Quartz de 6 campos. Macros, intervalos de execução e controle de sobreposição de tarefas.

Abrir ferramenta→

Guia de Expressões Regulares (RegEx) e Validação de Sintaxedeveloper

Folha de referência para sintaxe ECMAScript RegExp, grupos de captura nomeados, asserções lookaround e sinalizadores de execução.

Abrir ferramenta→

Codificador e Decodificador de URLdeveloper

Codifique e decodifique URLs e parâmetros de consulta com segurança usando RFC 3986, encodeURIComponent, encodeURI e formUrlEncoded.

Abrir ferramenta→

Codificador e Decodificador de Entidades HTMLdeveloper

Converta textos e códigos em entidades HTML nomeadas, decimais e hexadecimais para prevenir XSS e preservar caracteres especiais.

Abrir ferramenta→

Timestamp Unix e Conversor de Época Cheat Sheetdeveloper

Guia de tempo POSIX: conversão entre segundos, milissegundos, microssegundos e nanossegundos, fusos horários e representação ISO 8601.

Abrir ferramenta→

Calculadora de Permissões Chmod e Gerador de Comandosdeveloper

Calculadora visual de permissões de arquivos Linux e Unix. Converta modos octais e notação simbólica (rwxr-xr-x) em comandos chmod rapidamente.

Abrir ferramenta→