JSON Path

Para transformar os dados trazidos, no Zeev utilizamos o JSON Path

Para transformar os dados trazidos, no Zeev utilizamos o JSONPath que é uma linguagem usada para localizar e extrair dados específicos dentro de um objeto JSON - retorno de APIs do tipo Rest.

A função do JSON Path é manipular e filtrar dados dentro de retornos originais do JSON, que costumam ser complexos.

Tabela de operadores JSON Path

Operadores JSONPath são os símbolos e expressões que permitem navegar, selecionar e filtrar dados dentro de uma estrutura JSON. Eles definem como você percorre o objeto e quais elementos quer extrair.

Abaixo estão os principais operadores e o que cada um faz:

SÍMBOLO / SINTAXE	NOME	FUNÇÃO	APLICAÇÃO
$	Raiz	Representa o início do JSON	$
.	Navegação direta	Desce um nível hierárquico	$.cliente.nome
..	Descida recursiva	Procura o campo em qualquer nível da hierarquia (não importa onde esteja)	$..email
*	Coringa	Seleciona todos os elementos em um objeto ou array	$.cliente.*
[]	Índice ou chave	Seleciona um campo específico (por índice ou nome)	$.cliente['contatos'] ou $.cliente.pedidos[0]
[*]	Todos os índices de um array	Itera sobre todos os itens da lista	$.cliente.pedidos[*].valor
[0,2]	Índices múltiplos	Seleciona elementos específicos por posição	$.cliente.pedidos[0,2]
[start:end]	Intervalo (slice)	Seleciona intervalo de índices (como em Python)	$.cliente.pedidos[0:2]
?()	Filtro	Aplica condição booleana para filtrar itens	$.cliente.pedidos[?(@.valor > 200)]
@	Contexto atual	Refere-se ao elemento sendo avaliado em um filtro	?(@.status == 'ativo')
()	Expressão de script	Permite cálculo simples dentro da expressão	$.pedidos[?(@.valor + 10 > 300)]
['campo']	Nome literal	Alternativa ao ponto — útil para chaves com espaços, números ou caracteres especiais	$['dados do cliente'].nome

Exemplo prático