JSONPath
Gerador de JSONPath com IA
Início Rápido
Exemplo de Resposta JSON
Suponha que temos 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" }
]
}
}
Extrair Dados
Para extrair o Esta expressão devolve "Book 1".
title do primeiro book no array, utilize esta expressão JSONPath: $.store.book[0].titleExplicação da Expressão JSONPath
Vamos decompor 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: Acede à propriedade book sob o objeto store, que é um array.[0]: Seleciona o primeiro elemento no array book (os índices começam em 0).title: Obtém o title do primeiro livro no array.store, acede ao array book, seleciona o primeiro item e extrai o title desse item.Notas Importantes
0.$.store.book[?(@.category=='reference')].Visão Geral da Sintaxe
Sintaxe Básica
| Sintaxe | Descrição |
|---|---|
$ | Nó raiz |
@ | Nó atual |
.node or ['node'] | Aceder a nós filhos |
[index] | Indexação de arrays, suporta contagem a partir de 0 |
[start:end:step] | Fatiamento de arrays |
* | Caráter universal, corresponde a todos os nós filhos |
.. | Caráter universal recursivo, corresponde a todos os descendentes |
(<expr>) | Expressão dinâmica |
?(<boolean expr>) | Condição de filtro |
Sintaxe Alargada
| Sintaxe | Descrição |
|---|---|
^ | Aceder ao pai do item correspondente |
~ | Obter nomes de atributos do item correspondente (como um array) |
@null(), @boolean(), @number(), @string(), @array(), @object() | Obter tipos JSON básicos |
@integer() | Obter o tipo inteiro |
@scalar() | Obter tipos complexos, aceitando undefined e números não finitos (ao consultar objetos JavaScript) |
@other() | Pode ser utilizado com um otherTypeCallback definido pelo utilizador |
@undefined(), @function(), @nonFinite() | Tipos não JSON utilizados ao consultar objetos JavaScript não JSON |
@path, @parent, @property, @parentProperty, @root | Seletores abreviados em filtros |
` | Escapar as sequências restantes |
@['...'], ?@['...'] | Escapar caracteres especiais em nomes de atributos dentro de filtros |
$.. | Obter todos os componentes pai |
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)] or $..book[-1:] | Último livro |
//book[position()<3] | $..book[:2] or $..book[0,1] | Primeiros dois livros |
//book[isbn] | $..book[?(@.isbn)] | Livros com um ISBN |
//book[price<10] | $..book[?(@.price<10)] | Livros com preço inferior a 10 |
//* | $..* | Corresponder recursivamente a todos os nós filhos |
Testar Expressões JSONPath
Casos de Utilização no Apidog
Referências
Modified at 2026-06-09 08:54:45