Was ist GraphQL?

GraphQL: Definition und Bedeutung

Eine API ist die Schnittstelle, über die Programme Daten austauschen. GraphQL ist ein Ansatz dafür, bei dem der Client in der Anfrage genau beschreibt, welche Felder er braucht – und der Server liefert nur diese. Die Daten werden dabei als verknüpftes Netz („Graph“) von Objekten betrachtet, etwa Kunde, Bestellungen und Artikel.

GraphQL ist keine Datenbank und kein Ersatz für die Geschäftslogik, sondern eine einheitliche Schicht davor. Dahinter können Datenbanken, andere Schnittstellen oder Altsysteme stehen. Heute bieten viele Plattformen GraphQL an, darunter GitHub und Shopify für ihre Schnittstellen, und viele Unternehmen setzen es für die eigenen Anwendungen ein.

So funktioniert GraphQL

Der Server veröffentlicht ein Schema: Es beschreibt alle verfügbaren Typen, Felder und Beziehungen. Clients schicken meist per HTTP-POST an einen einzigen Endpunkt eine Abfrage (Query), mit der sie Daten lesen, oder eine Mutation, mit der sie Daten ändern. Für Echtzeit-Aktualisierungen gibt es zusätzlich Subscriptions.

Ein Beispiel: Eine App benötigt für eine Übersicht nur den Namen eines Kunden und die Nummern seiner letzten drei Bestellungen. Mit einer einzigen Abfrage holt sie genau das. Bei einer klassischen REST-API wären dafür oft mehrere Aufrufe nötig, die zudem mehr Felder liefern als gebraucht werden (Under- und Overfetching).

Praxis­bei­spiel: Ein Datenbestand, viele Oberflächen

Ein Möbelhersteller betreibt Onlineshop, Händlerportal und eine App für den Außendienst. Alle drei greifen auf dieselben Produktdaten zu, brauchen aber unterschiedliche Ausschnitte: Der Shop Bilder und Beschreibungen, das Händlerportal Einkaufspreise, die App nur Artikelnummer und Lagerbestand. Bisher gab es dafür drei getrennte Schnittstellen.

Mit GraphQL baut das Team eine gemeinsame Schicht, aus der jede Oberfläche genau die benötigten Felder abfragt. Neue Anforderungen erfordern oft keine neue Schnittstelle, sondern nur eine angepasste Abfrage. Rechte werden serverseitig geprüft, sodass das Händlerportal Einkaufspreise sehen darf, der öffentliche Shop dagegen nicht.

Vorteile, Grenzen und typische Fehler

Vorteile von GraphQL sind weniger Datenverkehr, ein selbsterklärendes Schema und eine schnelle Entwicklung von Frontends. Dem stehen Grenzen gegenüber: Zwischenspeichern ist aufwendiger als bei REST, offene Abfragen können den Server stark belasten, und der Einstieg verlangt mehr Know-how. Typische Fehler:

• GraphQL einsetzen, obwohl eine einfache REST-API völlig genügt
• Keine Begrenzung für Abfragetiefe und Komplexität, sodass einzelne Abfragen den Server überlasten
• Berechtigungen nur in der Oberfläche statt serverseitig auf jedem Feld prüfen
• Schemadetails und ausführliche Fehlermeldungen ungeschützt nach außen geben
• N+1-Datenbankabfragen im Server ignorieren

Worauf Unternehmen achten sollten

Ob GraphQL oder REST passt, hängt vom Einsatz ab: Viele unterschiedliche Clients und verschachtelte Daten sprechen für GraphQL, einfache Schnittstellen und gut zwischenspeicherbare Daten für REST. Nano Concepts entwickelt beide Varianten, sichert sie ab (Authentifizierung, Limits, Monitoring) und dokumentiert die API so, dass Partner und Frontend-Teams sie schnell nutzen können.