← Tools-Übersicht100% Client-seitig

GraphQL-SDL-zu-JSON-Schema- und OpenAPI-Konverter

Konvertieren Sie GraphQL-SDL-Schemadefinitionen, -Typen, -Queries und -Mutationen direkt in standardkonforme JSON-Schema-Draft-07- und OpenAPI-Komponenten-Schemas.

Zielspezifikation:

Feld-Docstrings einbeziehenStrikte Non-Null-Felder erzwingen

GraphQL SDL-Eingabe47 lines

Generierte Schema-Ausgabe

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

Geparste Typen

5definitions

Konvertierte Felder

20attributes

Schema-Größe

JSON Schema Draft-07

Technische Referenz & Architektur-Leitfaden

GraphQL-SDL-zu-JSON-Schema- und OpenAPI-Konverter — Referenz-Leitfaden

Konvertieren Sie GraphQL-SDL-Schemadefinitionen, -Typen, -Queries und -Mutationen direkt in standardkonforme JSON-Schema-Draft-07- und OpenAPI-Komponenten-Schemas.

Wichtige Parameter & Steuerelemente

schemaSdlstring

Der unformatierte GraphQL Schema Definition Language (SDL) Quelltext, der Typen, Inputs, Enums, Unions, Queries und Mutationen definiert.

targetFormatstring

Ziel-Schemaspezifikationsformat für die Ausgabe, wie z. B. 'json-schema-draft-07', 'json-schema-2020-12', 'openapi-3.0' oder 'openapi-3.1'.

includeDirectivesboolean

Gibt an, ob benutzerdefinierte GraphQL-SDL-Direktiven (z. B. @deprecated, @description, Validierungsregeln) in Standard-Schema-Schlüsselwörter oder Erweiterungen wie 'x-graphql-directives' übersetzt werden sollen.

nullableFieldsStrategystring

Behandlungsstrategie für nullable GraphQL-Felder gegenüber Non-Null-Typen ('!'), abgebildet auf JSON-Schema 'type': ['string', 'null'] oder OpenAPI 'nullable: true'.

Profi-Tipps & Best Practices

Häufige Fallstricke & Fehlerbehebung

SyntaxError: Unerwartetes Zeichen / Unbekannter Typ beim SDL-Parsing

Validieren Sie die SDL vor der Konvertierung anhand der offiziellen GraphQL-Grammatikspezifikation. Stellen Sie sicher, dass alle benutzerdefinierten Skalare (z. B. DateTime, JSON, UUID) explizit mit 'scalar SkalarName' in der SDL deklariert sind.

Zyklische Referenzfehler oder Abstürze durch unendliche Aufrufstapel (Call Stack Exceeded) während der Schemagenerierung

Deaktivieren Sie die Inline-Schemarekursion und aktivieren Sie die referenzbasierte Generierung mit Bezeichnern unter '#/components/schemas' oder '#/definitions', sodass zirkuläre Strukturen über JSON-Pointer aufgelöst werden.

OpenAPI-3.0-Validierungsfehler aufgrund von Konstrukten wie 'type: ["string", "null"]'

Legen Sie das Zielformat explizit auf OpenAPI 3.0 fest, um 'type: string' in Kombination mit 'nullable: true' zu verwenden, da Typ-Arrays vor OpenAPI 3.1 und JSON Schema Draft-2020-12 nicht unterstützt werden.

Häufig gestellte Fragen (FAQ)

▼