Buscador JSON Path Online

Um caminho JSON é a sequência de chaves e índices de array necessária para acessar um valor específico em uma estrutura JSON aninhada. Por exemplo, em um objeto com chave user contendo name, o caminho para o nome seria user.name em notação de ponto, ou $.user.name em sintaxe JSONPath. Caminhos são essenciais para extrair valores programaticamente, configurar regras de negócio baseadas em dados JSON e escrever consultas de transformação de dados.

JSONPath é uma linguagem de consulta para JSON, análoga ao XPath para XML, proposta por Stefan Goessner em 2007. O sinal $ representa a raiz do documento. O ponto . acessa uma propriedade de objeto: $.store.book. Colchetes [] acessam índices de array: $.users[0]. Consultas recursivas usam ..: $..name recupera todos os campos name em qualquer nível. Filtros são expressos como [?(@.price < 10)].

Caminhos JSON têm vários usos práticos: (1) depuração de API — identificar exatamente onde um valor está em uma resposta grande; (2) consultas jq — extrair valores no terminal; (3) extração de configuração — scripts que leem valores de arquivos de config JSON complexos; (4) transformações de dados com ferramentas como JSONata ou jolt; (5) regras de validação em JSON Schema referenciando campos específicos.

Arrays em JSON são indexados a partir de zero. O primeiro elemento é [0], o segundo [1], e assim por diante. Em JSONPath, $.items[0] acessa o primeiro elemento, $.items[-1] o último (em implementações que suportam índices negativos), e $.items[0,2] acessa os elementos nos índices 0 e 2. Para acessar todos os elementos de um array, use o curinga: $.items[*].

A ferramenta lida com JSON em qualquer nível de aninhamento. Porém, para JSONs extremamente profundos ou com milhares de nós, renderizar a árvore interativa pode ficar mais lento em navegadores com recursos limitados. Na prática, a maioria das APIs REST e arquivos de config tem menos de 10 níveis de aninhamento, que a ferramenta trata sem nenhum problema.