GraphQL

Rechtsklick im Baum ▸ Hinzufügen ▸ GraphQL-Anfrage.

Konfiguration

Feld	Rolle
URL	Der GraphQL-Endpunkt
Operationstyp	query, mutation oder subscription
Anfrage	Das GraphQL-Dokument, mit Syntaxhervorhebung
Variablen	Die Variablen der Operation, in JSON
Operationsname	Erforderlich, sobald das Dokument mehrere benannte Operationen enthält
Header	Wie bei einer HTTP-Anfrage

Restorms {{variables}} funktionieren im Dokument ebenso wie in den GraphQL-Variablen — achten Sie darauf, die beiden Systeme nicht zu verwechseln: $id ist eine GraphQL-Variable, {{id}} eine Restorm-Variable.

Subscriptions

Ein subscription öffnet einen Stream: Die Nachrichten treffen fortlaufend im Antwortbereich ein. In einem Szenario steuern die Aktionen GraphQL abonnieren / GraphQL-Abonnement beenden denselben Stream und lösen pro empfangener Nachricht ein Ereignis aus.

Ein Schema importieren

Eine Datei .graphql / .gql (SDL) erzeugt eine vollständige Baumstruktur: ein Ordner pro Operationstyp, eine Anfrage pro Wurzelfeld, mit vorausgefüllten Argumentvariablen, der API-Dokumentation und den Aufzählungen. Siehe Ein GraphQL-Schema importieren.

Postman-, Bruno-, Insomnia- und Thunder-Client-Collections, deren Anfragen vom Typ GraphQL sind, werden als GraphQL-Anfragen importiert, nicht als HTTP-Anfragen.

Servermodus

Restorm kann einen GraphQL-Mock-Server hosten: Sie liefern das Schema (SDL) und wahlweise canned Werte pro Feld (Query.pets) oder ein Resolver-Skript in JavaScript, das ihnen vorgeht. Auch Subscriptions werden bedient. Siehe Eine GraphQL-API simulieren.

Code-Snippets

Dreizehn Ziele: cURL, JavaScript (Fetch, Apollo Client), TypeScript, Python (Requests, gql), Go (graphql-go), Ruby (graphql-client), PHP (Guzzle), C# (GraphQL.Client), Java (graphql-java), Swift (Apollo iOS), Kotlin (Apollo Kotlin).