Skip to content

2. Discovering Schema Information

Was ist Introspection (kurz)

Introspection ist ein eingebautes Feature von GraphQL: der Server kann (sofern aktiviert) das Schema über spezielle Felder offenlegen. Über diese Queries kannst du herausfinden, welche Typen, Queries, Mutations und Felder der Server anbietet — quasi automatische API-Dokumentation zur Laufzeit.

Wie du gezielt Mutations-Namen abfragst

Du musst nicht das ganze Schema abfragen. Wenn du nur die verfügbaren Mutations sehen willst, fragst du das __schema-Feld und dann mutationType → fields → name.

Beispiel-Query (minimal): 

{
  __schema {
    mutationType {
      fields {
        name
      }
    }
  }
}

Erklärung: - __schema ist ein spezielles Root-Feld für Introspection. - mutationType verweist auf den Mutation-Root (kann null sein, wenn keine Mutations existieren). - fields { name } listet alle Feldnamen (also die Mutation-Namen).

Visualisierung von Introspection results

Mit GraphQL visualizer lassen sich die introspections besser auslesen als raw.

Suggestions

Wenn Introspection deaktiviert dann könnte man trotzdem mit Suggestions informationen ermitteln. GraphQL-Server schlägt dann vor was man meinen könnte.