GraphQL

Einfach erklärt

GraphQL ist eine Alternative zu REST, bei der der Client genau bestimmt, welche Daten er braucht. Statt mehrerer Endpunkte gibt es einen einzigen – der Client formuliert eine Abfrage, die exakt die benötigten Felder spezifiziert.

Für KI-Anwendungen ist GraphQL besonders relevant, wenn Frontends dynamisch unterschiedliche Datenkombinationen benötigen – etwa ein Dashboard, das je nach Nutzerrolle andere Modell-Metriken anzeigt. Statt fünf REST-Endpunkte zu bauen, reicht eine flexible GraphQL-API. Der Nachteil: Caching ist komplexer als bei REST, und schlecht formulierte Queries können zu Performance-Problemen führen. GraphQL lohnt sich besonders bei komplexen, datenintensiven Frontends mit vielen verschiedenen Ansichten – für einfache APIs ist REST oft die bessere Wahl.ies können die Datenbank überlasten.

REST vs. GraphQL:

Aspekt	REST	GraphQL
Endpunkte	Viele (/users, /posts, /comments)	Einer (/graphql)
Datenumfang	Server bestimmt	Client bestimmt
Over-Fetching	Häufig	Nie
Typisierung	Optional (OpenAPI)	Eingebaut (Schema)

Beispiel-Query:

query {
  user(id: "123") {
    name
    email
    posts(last: 5) {
      title
      createdAt
    }
  }
}

Technischer Deep Dive

Schema Definition

type User {
  id: ID!
  name: String!
  email: String!
  posts: [Post!]!
}

type Query {
  user(id: ID!): User
  users(limit: Int): [User!]!
}

type Mutation {
  createUser(name: String!, email: String!): User!
}

Vorteile

• Kein Over-Fetching: Nur angeforderte Felder werden zurückgegeben
• Kein Under-Fetching: Alle benötigten Daten in einer Anfrage
• Introspection: Schema ist selbstdokumentierend
• Subscriptions: Echtzeit-Updates über WebSockets

Nachteile

• Komplexere Implementierung als REST
• Caching schwieriger (ein Endpunkt, variable Queries)
• N+1 Query Problem bei naiver Implementierung
• Overkill für einfache APIs