Generator für GraphQL-Typdefinitionen aus JSON

Generator für GraphQL-Typdefinitionen aus JSON

Fügen Sie ein beliebiges JSON-Objekt oder Array ein und erhalten Sie sofort eine GraphQL-Schema-Definition-Sprache (SDL)-Dokument, die die Struktur beschreibt. Der Generator durchläuft das JSON-Baum, infertiert skalare Typen, benennt verschachtelte Objekte, fügt Varianten von Arrays von Objekten zusammen und emittiert optional eine Wurzeltyp. Query typ, damit das Ergebnis direkt in einen Server wie Apollo, Yoga, Mercurius oder graphql-go eingefügt werden kann.

Warum ein deterministischer JSON-zu-GraphQL-SDL-Converter wichtig ist

Die manuelle Schreibweise von GraphQL-Typen aus einem Beispiel-Payload ist mechanisch, aber fehleranfällig. Ein verpasster nullbarer Wert, eine inkonsistente Int vs Floatoder ein vergessener nicht-null-Marker auf einem Liste-Element kann die Codegenerierung für alle nachfolgenden Clients beeinträchtigen. Ein regelbasiertes Generator behandelt denselben JSON-Payload immer gleich, was es sicher macht, ihn bei jeder Änderung des APIs zu regenerieren.

Nutzung

1. Fügen Sie ein JSON-Objekt oder Array in das Eingabefeld ein, oder klicken Sie Probieren Sie ein Beispiel aus um ein repräsentatives Payload zu laden.
2. Legen Sie die Typ des Wurzels wenn Sie etwas anderes als Root.
3. Wählen Sie einen Nullität des Felds Strategie – streng (!) für erforderliche Felder oder alle nullbar für Prototypen.
4. Umschalten Erkennung von ID um Schlüssel zu automatisch zu fördern id und *Id zum GraphQL ID Skalartyp.
5. Optional ein Wurzel Query typ mit einzelnen und Listen-Feldern einbeziehen.
6. Kopieren Sie die SDL oder laden Sie sie als schema.graphql.

Funktionen

• Skalare Inferenz – unterscheidet String, Int, Float, Booleanund ID deterministisch.
• Verschachtelte Objekt-Typen – erzeugt einen separaten benannten Typ für jedes verschachtelte Objekt mit PascalCase aus dem Feldschlüssel.
• Array von Objekten Zusammenführen – vereinigt alle Felder über die Array-Elemente, damit optionale Felder korrekt markiert werden.
• Nullbar vs. Nicht-Null-Wechsel – emittiert strenge ! Markierungen oder entspannt alles auf nullbar für frühe Prototypen.
• Automatische ID-Erkennung – erhebt id, userId, orderId Stil-Schlüssel zu dem ID Skalartyp.
• Wurzel-Abfrage-Grundgerüst – optional mit einzelnen und Listen-Resolver-Protokollen. type Query { ... } – Ihr JSON bleibt im Browser, daher ist das Tool sicher für sensible Payloads.
• Nur auf der Client-Seite verfügbar Typinferenz-Regeln

Ganze Zahlen werden auf

• abgebildet; Zahlen mit einem Bruchteil werden auf Intabgebildet. Ein Feld, das als beide gesehen wird, wird auf Floatabgebildet. Strings werden auf Float.
• abgebildet. Mit ID-Erkennung aktiv werden Schlüssel namens Stringoder endend mit id zu Id werden. Boolesche Werte werden auf ID.
• abgebildet. Werte, die auf null markiert sind, machen das Feld nullbar, sodass das erzeugte SDL das letzte Boolean.
• null überspringt. !.
• Leere Arrays werden standardmäßig auf [String] festgelegt, weil kein Elementtyp sicher abgeleitet werden kann.
• Arrays von Objekten werden zu einem benannten Typ zusammengeführt; Felder, die in keinem Element vorkommen, werden automatisch nullbar.

Für wen wird es verwendet?

• Backend-Entwickler, die einen REST-Endpunkt oder eine JSON-Datei in einen GraphQL-Gateway wrappen.
• Frontend-Entwickler, die einen Schema-Prototyp gegen ein Fixtures-Payload erstellen, bevor die API bereit ist.
• API-Designer, die die Antwortformen von Drittanbietern als typisierten Vertrag dokumentieren.
• Codegenerierungspipelines, die ein reproduzierbares SDL-Artefakt aus einem stabilen JSON-Beispiel benötigen.