GraphQL vs REST: API-Design Auswahlleitfaden

Was ist REST API?

REST (Representational State Transfer) ist ein API-architektonischer Stil, der auf dem HTTP-Protokoll aufbaut. Ressourcen werden durch URIs identifiziert.

Jeder Endpoint repräsentiert eine bestimmte Ressource oder Sammlung: GET /users, GET /users/123, POST /users.

CRUD-Operationen werden mit HTTP-Methoden (GET, POST, PUT, DELETE) durchgeführt. Antwortformat ist normalerweise JSON.

REST basiert auf stateless, cacheable und uniform interface Prinzipien. Nutzt alle HTTP-Features (Caching, Status Codes).

Was ist GraphQL?

GraphQL ist eine Abfragesprache und Runtime, entwickelt von Facebook. Der Client fragt genau die Daten ab, die er benötigt.

Einzelner Endpoint: /graphql. Client gibt in der Query an, welche Felder er möchte. Server gibt nur die angeforderten Felder zurück.

Schema: Typsystem der API. Datenmodell wird mit Type Definitions definiert. Query, Mutation und Subscription Typen.

Resolver: Funktionen, die für jedes Feld auf die Datenquelle zugreifen. Daten können aus Datenbank, REST API, Microservice usw. abgerufen werden.

Vergleich: Vor- und Nachteile

Over-fetching/Under-fetching: REST gibt unnötige Daten zurück (over-fetching) oder unzureichende Daten (under-fetching). GraphQL gibt genau die angeforderten Daten zurück.

Einzelne Anfrage: Mit GraphQL können mehrere Ressourcen in einer einzigen Anfrage abgerufen werden. Mit REST sind mehrere Anfragen nötig.

Caching: REST unterstützt HTTP-Caching (Cache-Control, ETag) natürlich. Caching in GraphQL ist komplexer (persisted queries, Apollo cache).

Lernkurve: REST wird mit HTTP-Wissen erlernt. GraphQL erfordert neue Konzepte wie Schema, Resolver, Query Language.

Tooling: Postman, Swagger für REST. GraphiQL, Apollo Studio für GraphQL. Beide haben gute Tooling-Ökosysteme.

Anwendungsfälle

REST bevorzugen: Einfache CRUD APIs, öffentliche APIs, wenn Caching wichtig ist, wenn Bandbreite für mobile Apps begrenzt ist.

GraphQL bevorzugen: Komplexe Datenanforderungen, mehrere Frontends (Web, Mobile, Desktop), Microservices-Aggregation, Echtzeit-Subscriptions.

Hybrid-Ansatz: REST für öffentliche API, GraphQL für intern/federation. Einige Unternehmen nutzen beides zusammen.

BFF (Backend for Frontend): Separate GraphQL-Schicht für jedes Frontend. Verschiedene Queries für Web und Mobile.

Performance-Vergleich

REST: HTTP-Caching, CDN-Unterstützung, einfaches Load Balancing. Jeder Endpoint kann unabhängig gecacht werden.

GraphQL: N+1 Problem (gelöst mit DataLoader), Query Complexity Analysis, Caching mit Persisted Queries.

Bandbreite: GraphQL verhindert unnötigen Datentransfer. Bietet Bandbreiteneinsparungen für mobile Apps.

Latenz: REST kann mehrere Round-Trips erfordern. GraphQL erhält alle Daten in einer einzigen Anfrage. Komplexe Queries können jedoch serverseitig langsam sein.

Auswahlkriterien

Team-Erfahrung: REST ist verbreiteter und bekannter. GraphQL erfordert mehr Lernen.

API-Consumer: REST für öffentliche API (breitere Kompatibilität). GraphQL für interne API (mehr Flexibilität).

Datenkomplexität: REST für einfache Datenmodelle. GraphQL für komplexe, verknüpfte Datenmodelle.

Caching-Anforderung: REST für Heavy Caching. GraphQL Subscriptions für Echtzeitdaten.

Migration: Bestehende REST API mit GraphQL wrappen (Schema Stitching, Federation). Schrittweise Übergang durchführen.