JSONPath
Gerador de JSONPath com IA
Início rápido
Exemplo de resposta JSON
Suponha que tenhamos a seguinte resposta JSON:
{
"store": {
"book": [
{ "category": "fiction", "author": "Author A", "title": "Book 1" },
{ "category": "reference", "author": "Author B", "title": "Book 2" },
{ "category": "fiction", "author": "Author C", "title": "Book 3" }
]
}
}
Extraindo dados
Para extrair o Esta expressão retorna "Book 1".
title do primeiro book no array, use esta expressão JSONPath: $.store.book[0].titleExplicação da expressão JSONPath
Vamos analisar a expressão Em resumo, a expressão navega a partir da raiz, encontra o objeto
$.store.book[0].title:$: refere-se ao nó raiz do documento JSON — essencialmente, toda a estrutura.store: aponta para a propriedade store, que é um objeto sob o nó raiz.book: acessa a propriedade book sob o objeto store, que é um array.[0]: seleciona o primeiro elemento no array book (os índices começam em 0).title: recupera o title do primeiro livro no array.store, acessa o array book, seleciona o primeiro item e extrai o title desse item.Observações importantes
0.$.store.book[?(@.category=='reference')].Visão geral da sintaxe
Sintaxe básica
| Sintaxe | Descrição |
|---|---|
$ | Nó raiz |
@ | Nó atual |
.node ou ['node'] | Acessar nós filhos |
[index] | Indexação de array, oferece suporte à contagem a partir de 0 |
[start:end:step] | Fatiamento de array |
* | Curinga, corresponde a todos os nós filhos |
.. | Curinga recursivo, corresponde a todos os descendentes |
(<expr>) | Expressão dinâmica |
?(<boolean expr>) | Condição de filtro |
Sintaxe estendida
| Sintaxe | Descrição |
|---|---|
^ | Acessa o pai do item correspondente |
~ | Obtém nomes de atributos do item correspondente (como um array) |
@null(), @boolean(), @number(), @string(), @array(), @object() | Recupera tipos JSON básicos |
@integer() | Recupera o tipo inteiro |
@scalar() | Recupera tipos complexos, aceitando undefined e números não finitos (ao consultar objetos JavaScript) |
@other() | Pode ser usado com um otherTypeCallback definido pelo usuário |
@undefined(), @function(), @nonFinite() | Tipos não JSON usados ao consultar objetos JavaScript não JSON |
@path, @parent, @property, @parentProperty, @root | Seletores abreviados em filtros |
` | Escapa as sequências restantes |
@['...'], ?@['...'] | Escapa caracteres especiais em nomes de atributos dentro de filtros |
$.. | Recupera todos os componentes pais |
Exemplos de JSONPath
Dados JSON de exemplo
{
"store": {
"book": [
{
"category": "reference",
"author": "Nigel Rees",
"title": "Sayings of the Century",
"price": 8.95
},
{
"category": "fiction",
"author": "Evelyn Waugh",
"title": "Sword of Honour",
"price": 12.99
},
{
"category": "fiction",
"author": "Herman Melville",
"title": "Moby Dick",
"isbn": "0-553-21311-3",
"price": 8.99
},
{
"category": "fiction",
"author": "J. R. R. Tolkien",
"title": "The Lord of the Rings",
"isbn": "0-395-19395-8",
"price": 22.99
}
],
"bicycle": {
"color": "red",
"price": 19.95
}
}
}Exemplos de consultas comuns
| XPath | JSONPath | Resultado |
|---|---|---|
/store/book/author | $.store.book[*].author | Autores de todos os livros |
//author | $..author | Todos os autores |
/store/* | $.store.* | Todos os nós filhos sob store |
/store//price | $.store..price | Todos os campos de preço |
//book[3] | $..book[2] | Terceiro livro (índice baseado em 0) |
//book[last()] | $..book[(@.length-1)] ou $..book[-1:] | Último livro |
//book[position()<3] | $..book[:2] ou $..book[0,1] | Primeiros dois livros |
//book[isbn] | $..book[?(@.isbn)] | Livros com ISBN |
//book[price<10] | $..book[?(@.price<10)] | Livros com preço abaixo de 10 |
//* | $..* | Corresponde recursivamente a todos os nós filhos |
Testando expressões JSONPath
Casos de uso no Apidog
Referências
Modified at 2026-06-11 10:21:25