GraphQL-Abfrage-Builder
Erstellen Sie GraphQL-Abfragen, Mutationen und Subscriptions visuell mit dynamischen Feldbäumen, Variablen, Fragmenten und Live-Ausgabe.
Aktualisiert am
GraphQL Query Builder
Visually build GraphQL queries, mutations, and subscriptions with a dynamic field tree, variables, and fragments.
Presets
Operation
Fields
Variables
No variables defined.
Fragments
No fragments defined.
GraphQL Query
Variables JSON
Häufig gestellte Fragen
Was ist der GraphQL-Abfrage-Builder?
Der GraphQL-Abfrage-Builder ist ein kostenloses Online-Tool, mit dem du GraphQL-Abfragen, -Mutationen und -Abonnements visuell erstellst, mit dynamischen Feldbäumen, Variablen, Fragmenten und Live-Ausgabe. Er läuft vollständig in deinem Browser, ohne Installation oder Anmeldung.
Welche Operationen?
Query, Mutation und Subscription. Der Builder passt die Syntax je nach Operationstyp an.
Variablen und Fragmente?
Definiere typisierte Variablen ($userId: ID!) im Bereich Variablen und referenziere sie in den Argumenten. Fragmente definieren wiederverwendbare Feldauswahlen für einen Typ.
Ist es kostenlos?
Ja, clientseitig, ohne Registrierung und ohne Server.
Sind meine Daten mit diesem Tool sicher?
Absolut. Der GraphQL-Abfrage-Builder verarbeitet alles clientseitig in deinem Browser. Es werden keine Daten auf einen Server hochgeladen oder dort gespeichert. Deine Inhalte bleiben jederzeit privat auf deinem Gerät.
Funktioniert der GraphQL-Abfrage-Builder auf Mobilgeräten?
Ja, der GraphQL-Abfrage-Builder ist vollständig responsiv und funktioniert auf Smartphones und Tablets. Du kannst ihn auf jedem Gerät mit einem modernen Webbrowser nutzen, ganz ohne App-Download.
Muss ich ein Konto erstellen, um dieses Tool zu nutzen?
Es ist kein Konto und keine Registrierung erforderlich. Öffne einfach den GraphQL-Abfrage-Builder in deinem Browser und beginne sofort mit der Nutzung. Es gibt keine Anmeldeschranken oder Nutzungsbeschränkungen.
Welche Programmiersprachen oder Formate werden unterstützt?
Der GraphQL-Abfrage-Builder unterstützt eine breite Palette beliebter Formate und Sprachen. In der Tool-Oberfläche findest du die vollständige Liste der unterstützten Optionen.
Wie verwende ich den GraphQL-Abfrage-Builder?
Gib einfach deine Eingabe in das vorgesehene Feld ein, passe die Einstellungen nach Wunsch an, und das Tool verarbeitet sie sofort. Anschließend kannst du das Ergebnis in die Zwischenablage kopieren oder herunterladen.
Welche Browser werden unterstützt?
Der GraphQL-Abfrage-Builder funktioniert in allen modernen Browsern, darunter Chrome, Firefox, Safari, Edge und Opera. Für das beste Erlebnis verwende die neueste Version deines bevorzugten Browsers.
Was ist der Unterschied zwischen einer GraphQL-Query und einer Mutation?
Eine Query liest Daten, ohne etwas zu verändern — sie fragt beim Server gezielt Felder ab und bekommt sie zurück, ähnlich wie ein GET-Request. Eine Mutation schreibt Daten: Sie erstellt, aktualisiert oder löscht Datensätze und gibt in der Regel das betroffene Objekt zurück, damit du die Änderung bestätigen kannst. Beide verwenden dieselbe Selection-Set-Syntax, um festzulegen, welche Felder zurückkommen, deklarieren aber unterschiedliche Operations-Schlüsselwörter (query versus mutation), und Mutationen benötigen fast immer Input-Argumente, oft eine typisierte Variable wie ein Input-Objekt. Daneben gibt es noch einen dritten Typ, subscription, der eine Verbindung für Echtzeit-Updates offenhält. In diesem Builder wählst du den Operationstyp vorab aus, und er passt das generierte Schlüsselwort und die Struktur entsprechend an, sodass du zwischen einer lesenden Query und einer schreibenden Mutation wechseln kannst, ohne die Umgebung von Hand neu zu schreiben.
Wie übergebe ich Variablen an eine GraphQL-Query, statt Werte fest zu codieren?
Deklariere jede Eingabe als benannte Variable in der Operationssignatur, gib ihr einen GraphQL-Typ wie ID!, Int oder String, und referenziere sie dann innerhalb eines Arguments mit einem Dollarzeichen — zum Beispiel user(id: $userId). Werte separat als JSON-Objekt zu senden, hält die Query wiederverwendbar, ermöglicht deinem Client das Caching und vermeidet die Quoting- und Escaping-Fehler, die entstehen, wenn Rohwerte direkt in den String eingefügt werden. Das Ausrufezeichen nach einem Typ bedeutet, dass die Variable erforderlich ist. In diesem Builder werden deklarierte Variablen im Bereich Variables automatisch in die Signatur übernommen, und ein Wert, der innerhalb eines Arguments mit $ beginnt, wird automatisch als Variablenreferenz erkannt. Zusätzlich erzeugt der Builder ein direkt einfügbares Variables-JSON-Objekt neben der Query, sodass du beides sofort in Postman oder deinen API-Client übernehmen kannst.
Was ist ein GraphQL-Fragment, und wann sollte ich eines verwenden?
Ein Fragment ist eine benannte, wiederverwendbare Menge von Feldern, die auf einem bestimmten Typ definiert wird — zum Beispiel fragment UserFields on User { id name email }. Statt dieselbe Feldauswahl an mehreren Stellen zu wiederholen, definierst du sie einmal und fügst sie überall ein, wo du diese Felder brauchst. Fragments halten große Queries lesbar, garantieren, dass zwei Teile einer Anfrage dieselbe Struktur abfragen, und erleichtern Schemaänderungen, weil du die Feldliste nur an einer Stelle bearbeitest. Besonders nützlich sind sie, wenn mehrere Queries denselben Objekttyp zurückgeben oder wenn eine UI-Komponente immer dieselben Eigenschaften benötigt. In diesem Builder fügst du ein Fragment hinzu, vergibst einen Namen und einen Zieltyp und baust seinen Feldbaum genauso auf wie die Hauptauswahl — die generierte Ausgabe enthält die Fragment-Definition, sodass sie sofort einsatzbereit ist.
Warum liefert GraphQL nur die Felder zurück, nach denen ich frage?
GraphQL ist so konzipiert, dass der Client genau festlegt, welche Felder er möchte, und der Server nur diese zurückgibt — nicht mehr. Das ist das Gegenteil eines typischen REST-Endpunkts, der unabhängig davon, was du tatsächlich brauchst, immer eine feste Nutzlast sendet. Präzise Felder anzufragen bedeutet kleinere Antworten, weniger Over-Fetching von Daten, die du ohnehin verwirfst, und keine zusätzlichen Round-Trips, um verknüpfte Datensätze zu holen, da du Unterauswahlen verschachteln kannst, um verbundene Objekte in einer einzigen Anfrage abzuholen. Der Trade-off ist, dass jedes gewünschte Feld explizit im Selection Set genannt werden muss, was mit wachsender Query-Größe leicht auf subtile Weise falsch gemacht wird. Dieser Builder macht diese explizite Auswahl visuell — du klickst, um Felder beliebig tief hinzuzufügen und zu verschachteln, und er schreibt das passende Selection Set, sodass die Struktur genau die benötigte Datenform widerspiegelt.
Was ist der Unterschied zwischen formatierter und minifizierter GraphQL-Ausgabe?
Formatierte Ausgabe wird über mehrere Zeilen mit einheitlicher Einrückung dargestellt, sodass verschachtelte Selection Sets, Argumente und Fragments leicht zu lesen und zu überprüfen sind — das ist das Format, das du beim Commit einer Query in die Versionskontrolle oder beim Teilen mit Teamkollegen willst. Minifizierte Ausgabe komprimiert dieselbe Query auf eine einzige Zeile ohne überflüssige Leerzeichen, was praktisch ist, wenn du den Query-String direkt in Code oder einen Konfigurationswert einbettest, wo Zeilenumbrüche unpraktisch wären. Für den Server sind beide funktional identisch; nur die Leerzeichen unterscheiden sich, sodass du jederzeit zwischen beiden wechseln kannst, ohne das Verhalten zu ändern. In diesem Builder wechselt ein einzelner Schalter sofort zwischen den beiden Ansichten, und aus beiden heraus kannst du die Query kopieren, das Variables-JSON kopieren oder die Operation als .graphql-Datei herunterladen.
Verwandte Tools
Kostenloser API-Tester Online
Testen Sie REST-APIs mit GET-, POST-, PUT- und DELETE-Anfragen. Kostenlos, schnell und komplett im Browser, ohne Anmeldung.
Kostenloser cURL-zu-Code-Konverter
Wandeln Sie cURL-Befehle in JavaScript-, Python- oder PHP-Code um. Kostenlos, schnell und komplett im Browser, ohne Anmeldung.
Kostenloser JSON-Schema-Generator
Erzeugen Sie automatisch ein JSON Schema aus Ihren JSON-Daten. Kostenlos, schnell und komplett im Browser, ohne Anmeldung.
Kostenloser HTTP-Header-Parser
Analysieren und untersuchen Sie HTTP-Header aus Anfragen und Antworten. Kostenlos, schnell und komplett im Browser, ohne Anmeldung.
Über den GraphQL Query Builder
Der GraphQL Query Builder ist ein kostenloses visuelles Tool, mit dem du GraphQL-Operationen zusammenstellst, ohne die Syntax von Hand zu tippen. Du baust eine Query per Klick auf — Felder hinzufügen, Unterauswahlen verschachteln, Argumente anhängen, Variablen deklarieren und Fragments definieren — und das Tool schreibt dir in Echtzeit den passenden GraphQL-String. Es richtet sich an Entwickler, die eine GraphQL-API anbinden, an QA-Ingenieure, die Testanfragen bauen, sowie an alle, die ungefähr wissen, welche Daten sie brauchen, sich aber nicht mit geschweiften Klammern, Kommas und Argument-Quoting von Hand herumschlagen wollen.
GraphQL ist eine Abfragesprache für APIs, bei der der Client genau festlegt, welche Felder er benötigt, und der Server nur diese zurückliefert. Diese Präzision ist die große Stärke — aber die Syntax, mit verschachtelten Selection Sets, typisierten Variablendeklarationen wie $userId: ID!, benannten Operationen und Fragments, lässt sich leicht auf subtile Weise falsch schreiben. Dieser Builder nimmt dir genau diese Fehlerquelle ab, indem er aus einem strukturierten Formular gültige Ausgabe erzeugt.
So baust du eine Query
Die Oberfläche teilt sich in einen Builder auf der linken Seite und die Live-Ausgabe auf der rechten. Zu Beginn wählst du den Operationstyp — Query, Mutation oder Subscription — und kannst optional einen Namen vergeben (zum Beispiel GetUser). Der Builder passt das generierte Schlüsselwort automatisch daran an.
Der Bereich Fields ist ein dynamischer Baum. Jedes Feld kann Folgendes enthalten:
- Einen Alias, um ein Feld in der Antwort umzubenennen
- Einen Feldnamen, die eigentliche Eigenschaft in deinem Schema
- Verschachtelte Unterfelder, beliebig tief hinzufügbar, damit die Selection Sets deine Datenstruktur widerspiegeln
- Argumente, jeweils mit Name, Typ und Wert — tippst du einen Wert, der mit
$beginnt, erkennt der Builder ihn automatisch als Variablenreferenz
Drei fertige Vorlagen — eine Single-Record-User-Query, eine Create-Mutation und eine cursor-basierte paginierte Listen-Query — laden vollständige Beispiele, die du bearbeiten kannst. Das ist der schnellste Weg, um die korrekte Struktur eines gängigen Musters zu sehen.
Variablen und Fragments
Im Bereich Variables kannst du typisierte, wiederverwendbare Eingaben deklarieren. Jede Variable hat einen Namen, einen GraphQL-Typ wie ID!, Int oder String sowie optional einen Standardwert. Der Builder trägt sie in die Operationssignatur ein — query GetUser($userId: ID!) — und erzeugt zusätzlich ein separates Variables-JSON-Objekt, das du direkt in einen Client, in Postman oder in deinen API-Testablauf einfügen kannst.
Mit Fragments definierst du eine benannte, wiederverwendbare Menge von Feldern auf einem bestimmten Typ (fragment UserFields on User { ... }), damit eine Auswahl mehrfach verwendet statt wiederholt werden kann. Füge ein Fragment hinzu, gib ihm einen Namen und einen Zieltyp, und baue seinen Feldbaum genauso auf wie die Haupt-Query.
Der Generator kümmert sich außerdem korrekt um die Formatierung von Werten: Ganzzahlen und Fließkommazahlen werden unquotiert ausgegeben, Booleans klein geschrieben, Objekt- und Array-Literale unverändert durchgereicht, und einfache Strings werden in Anführungszeichen gesetzt, wobei enthaltene Anführungszeichen escaped werden — genau so, wie ein GraphQL-Server literale Argumente erwartet.
Ausgabe, Export und Datenschutz
Die Ausgabe aktualisiert sich sofort, während du editierst. Ein Umschalter wechselt zwischen formatierter mehrzeiliger Darstellung (gut lesbar, bereit für die Versionskontrolle) und minifizierter einzeiliger Ausgabe (kompakt, praktisch zum Einbetten in Code). Von dort aus kannst du die Query kopieren, das Variables-JSON kopieren oder die Operation als .graphql-Datei herunterladen. Eine Statuszeile fasst den Operationstyp, die Anzahl der Root-Felder sowie die Zahl der verwendeten Variablen und Fragments zusammen.
Alles läuft vollständig in deinem Browser. Der Builder erzeugt den Query-String lokal, ohne Netzwerkaufruf — deine Feldnamen, Schema-Details und eventuelle Beispielwerte verlassen also niemals dein Gerät. Praktisch, wenn du gegen eine noch unveröffentlichte interne API entwirfst. Es gibt kein Konto, keine Installation und kein Nutzungslimit, und weil alles clientseitig läuft, funktioniert das Tool sogar weiter, nachdem die Seite offline geladen wurde.
Wähle oben eine Vorlage aus oder füge dein erstes Feld hinzu, um mit der Generierung einer Query zu beginnen.