JSON-Abfrage

Holen Sie mit JSONPath genau die Werte heraus, die Sie aus JSON-Daten brauchen.

Ergebnis

Anwendungsbeispiele

Nur die benötigten Felder aus einer großen API-Antwort herausziehen

Statt die gesamte Antwort-JSON zu durchsuchen, holen Sie mit einem Pfad wie $.data.items[*].id genau das, was Sie brauchen, auf einmal.

Einträge herausfiltern, die eine Bedingung erfüllen

Verwenden Sie einen Filterausdruck wie $.products[?(@.price<10000)], um auf Einträge einzugrenzen, die eine Bedingung bei Preis, Lagerbestand oder anderem erfüllen.

Einen bestimmten Schlüssel überall in einer verschachtelten Struktur finden

Die rekursive Abstiegssyntax $..price findet jeden Schlüssel mit diesem Namen überall im Dokument, unabhängig von Tiefe oder Position.

Das letzte Element eines Arrays abgreifen

Verwenden Sie $.orders[-1:], um den neuesten Eintrag aus einem wachsenden Array aus Logs oder Bestellungen zu holen, ohne zu zählen, wie viele Elemente es enthält.

Mehrere bestimmte Felder auf einmal extrahieren

Ein Union-Ausdruck wie $.user['name','email','id'] liefert nur diese drei Felder eines Objekts und überspringt alles andere in einem großen Benutzerdatensatz.

Die Struktur einer unbekannten API-Nutzlast prüfen

Sie wissen nicht, wie tief ein Feld in einer Antwort verschachtelt ist, die Sie noch nie gesehen haben? Beginnen Sie mit $..fieldName, um es überall zu finden, und grenzen Sie dann auf den genauen Pfad ein, sobald Sie sehen, wo es liegt.

Häufig gestellte Fragen

Werden das eingegebene JSON und der Ausdruck an einen Server gesendet?

Nein. Die Abfrage läuft vollständig in Ihrem Browser, und das Eingegebene wird nie an einen Server gesendet.

Ich erinnere mich nicht an die JSONPath-Syntax.

Häufige Muster: $ steht für das gesamte Dokument, .key für einen bestimmten Schlüssel, [*] für jedes Element eines Arrays, [0] für das erste Element, [?(@.price<10)] filtert nach einer Bedingung, und $..key findet jeden Schlüssel mit diesem Namen in beliebiger Tiefe.

Mein Ergebnis ist leer – warum?

Das kann bedeuten, dass der Pfad auf keine echten Daten verweist, oder dass der Ausdruck einen Syntaxfehler hat — beides zeigt sich als leeres Ergebnis. Versuchen Sie, den Pfad schrittweise zu kürzen, um zu sehen, wo er nicht mehr trifft.

Ist das Abfrageergebnis immer ein Array?

Ja. JSONPath sammelt jeden passenden Wert in einem Array, selbst wenn genau ein Wert passt — Sie erhalten ein Array der Länge eins.

Ist das JSONPath-, JMESPath- oder jq-Syntax?

JSONPath, ausgewertet mit der Bibliothek jsonpath-plus. Sie unterstützt die Standardsyntax $, ., [*], [n] und $..key sowie Erweiterungen wie Filterausdrücke ([?(@.price<10)]) und Skriptausdrücke – ist aber nicht kompatibel mit der Abfragesyntax von jq oder JMESPath, die andere Operatoren verwenden.

Kann ich ein Array nach mehr als einer Bedingung filtern?

Ja – kombinieren Sie Bedingungen mit && oder || innerhalb eines Filterausdrucks, zum Beispiel $.products[?(@.price<100 && @.inStock==true)], um Artikel zu finden, die sowohl günstig als auch auf Lager sind.

Unterstützt der Pfad negative Array-Indizes oder Slices?

Ja. [-1] bezeichnet das letzte Element, und Slice-Syntax wie [1:3] oder [-2:] funktioniert genauso wie in Python, sodass Sie einen Bereich von Elementen abgreifen können, ohne die genaue Länge des Arrays zu kennen.