Cerca JSON Path Online

Un percorso JSON e la sequenza di chiavi e indici di array necessaria per accedere a un valore specifico in una struttura JSON annidata. Ad esempio, nel JSON con campo user che contiene name, il percorso verso il nome sarebbe user.name in notazione punto, o $.user.name in sintassi JSONPath. I percorsi sono indispensabili per estrarre valori in modo programmatico, configurare regole business basate su dati JSON e scrivere query di trasformazione dati.

JSONPath e un linguaggio di query per JSON, analogo a XPath per XML, proposto da Stefan Goessner nel 2007. Il simbolo $ rappresenta la radice del documento. Il punto . accede a una proprieta di oggetto come $.store.book. Le parentesi quadre accedono agli indici di array come $.users[0]. Le query ricorsive usano i due punti doppi: $..name recupera tutti i campi name a qualsiasi livello. I filtri si esprimono come [?(@.price < 10)].

I percorsi JSON hanno molteplici usi pratici: debug delle API per identificare esattamente dove si trova un valore in una risposta ampia, query jq per estrarre valori nel terminale, estrazione di configurazione da file JSON complessi, trasformazioni dati con strumenti come JSONata o jolt, e regole di validazione in JSON Schema che referenziano campi specifici.

Gli array in JSON sono indicizzati a partire da zero. Il primo elemento e [0], il secondo [1] e cosi via. In JSONPath, $.items[0] accede al primo elemento, $.items[-1] all'ultimo nelle implementazioni che supportano indici negativi, e $.items[0,2] accede agli elementi agli indici 0 e 2. Per accedere a tutti gli elementi di un array si usa il wildcard: $.items[*].

Lo strumento gestisce JSON con qualsiasi livello di annidamento. Tuttavia, per JSON estremamente profondi o con migliaia di nodi, il rendering dell'albero interattivo puo rallentare nei browser con risorse limitate. In pratica, la maggior parte delle API REST e dei file di configurazione ha meno di 10 livelli di annidamento, che lo strumento gestisce senza alcun problema.