Inhaltsverzeichnis
3.1 GraphQL Grundlagen
GraphQL1) ermöglicht flexible, präzise Datenabfragen.
Was ist GraphQL?
GraphQL2) ist eine Query-Sprache für APIs und eine Laufzeitumgebung zum Ausführen dieser Queries. Im Gegensatz zu REST3) können Clients genau die Daten anfordern, die sie benötigen.
Endpunkt
POST /api/v1/dsn/{dbName}/graphql
Content-Type: application/json
Einfache Query
{ "query": "{ customers { id name country } }" }
Mit Parametern
{ "query": "{ customers(first: 10, filter: \"Country eq 'DE'\") { id name } }" }
Schema abrufen
GET /api/v1/dsn/demo/graphql/schema
Liefert das GraphQL-Schema im SDL4)-Format.
Vorteile gegenüber REST
| Aspekt | REST | GraphQL |
|---|---|---|
| Endpunkte | Viele (pro Ressource) | Einer |
| Over-fetching | Häufig | Nie |
| Under-fetching | Häufig (N+1) | Nie |
| Typsicherheit | Optional | Eingebaut |
| Dokumentation | Extern (OpenAPI5)) | Integriert (Introspection) |
Quellen
1)
GraphQL Spezifikation: https://spec.graphql.org/
2)
GraphQL Foundation: https://graphql.org/
3)
Representational State Transfer: https://de.wikipedia.org/wiki/Representational_State_Transfer
4)
Schema Definition Language: https://graphql.org/learn/schema/
5)
OpenAPI Specification: https://www.openapis.org/
Zuletzt geändert: den 29.01.2026 um 15:12
