Consultar valores com JSON Pointer

Consultar valores com JSON PointerUsos e orientação prática

JSON Pointer identifica um valor usando um caminho específico dentro de um documento JSON. É útil quando uma resposta contém objetos e arrays aninhados, mas você só precisa de um membro. Cada segmento de caminho começa com uma barra. Em /users/0/name, os usuários selecionam um membro de objeto raiz, 0 seleciona o primeiro item de matriz e o nome seleciona o membro desse item. A pesquisa não pesquisa o documento inteiro: segue segmentos em ordem e para com um erro quando um segmento não pode ser resolvido. Isso distingue um caminho incorreto de um valor existente que é nulo.

Um caminho vazio seleciona o documento inteiro. Uma única barra seleciona um membro do objeto cujo nome é a string vazia, se esse membro existir. Uma barra literal em um nome de membro é codificado como 1 dentro de um segmento; um til literal é codificado como 0. Por exemplo, /a~1b seleciona o membro a/b. A sequência 01 representa o texto 1 ao invés de uma barra. O espaço em branco do caminho não é aparado porque os espaços podem ser partes significativas dos nomes dos membros. Os nomes devem corresponder exatamente: letras maiúsculas não são ignoradas e acentos ou formulários de normalização Unicode diferentes não são tratados como equivalentes.

Os índices de matriz começam em zero e devem ser escritos como inteiros não negativos sem zeros principais. /items/01 não seleciona o segundo item. Um hífen também não é interpretado como o último item; essa pesquisa recupera apenas valores que já existem. Um nome como construtor só é acessível quando é um membro do objeto JSON, em vez de algo herdado da cadeia de protótipos do JavaScript. A interface aceita a forma textual de JSON Pointer, não expressões JSONPath com curingas, filtros ou sinais de dólar, e não a representação do URI-fragmento de um ponteiro.

A saída preserva o tipo JSON do valor selecionado. Strings aparecem entre aspas, números permanecem números, nulos permanecem nulos, e objetos ou matrizes são mostrados como JSON recuado. Isso torna fragmentos baixados interpretáveis por outro programa. A análise rejeita chaves duplicadas para evitar a seleção ambígua de membros e inteiros fora do alcance seguro do navegador para evitar a perda de precisão. Identificadores numéricos longos devem ser fornecidos como strings pelo sistema de origem. A entrada suporta um milhão de caracteres, cem níveis de aninhamento e um número limitado de elementos para manter a página responsiva. Para documentos maiores, primeiro reduza o conteúdo mantendo a estrutura necessária pelo caminho selecionado e verifique o valor extraído contra a fonte original.