Achatar JSON aninhado em tabela com chaves de notação de ponto

Cada propriedade aninhada recebe um caminho em notação de ponto, e as posições dos arrays viram segmentos numéricos; assim, um identificador de pedido pode ser acessado sempre como orders.0.id. O resultado é útil em planilhas, tabelas de preparação de bancos de dados, logs, ferramentas de mapeamento e qualquer fluxo que precise de caminhos previsíveis em vez de estruturas aninhadas. O processamento é determinístico, preserva os tipos de valor JSON e rejeita JSON malformado ou uma raiz escalar com um erro claro de entrada.

Transforme estruturas aninhadas em caminhos previsíveis

O JSON aninhado é ideal para API porque mantém valores relacionados juntos, mas muitas ferramentas de relatórios e importação esperam uma sequência plana de campos. Esta capacidade percorre cada propriedade de objeto e cada elemento de array, unindo todos os segmentos com um ponto. Um valor armazenado em um objeto customer e depois em uma propriedade name passa a ser customer.name. O primeiro elemento de um array orders é endereçado por orders.0, portanto seu identificador vira orders.0.id. Cada folha é devolvida como uma linha com chave e valor, o que torna a saída fácil de exibir, filtrar ou transformar em colunas. O percurso segue a ordem presente no JSON analisado e fornece resultados estáveis para a mesma entrada. Strings continuam strings, números continuam números, booleanos continuam booleanos e null permanece null. Objetos e arrays vazios são emitidos como valores, em vez de desaparecerem silenciosamente, para que a saída achatada ainda registre que esses caminhos existiam no documento de origem.

Prepare a entrada e interprete a saída

Forneça o documento JSON completo como texto no campo json. A raiz deve ser um objeto ou um array. Essa exigência evita uma chave vazia ambígua para strings, números, booleanos ou null isolados. Os nomes das propriedades do objeto são usados exatamente como fornecidos, enquanto os índices de array são escritos como segmentos numéricos iniciados em zero. A resposta contém pairs, um array cujas entradas têm os campos key e value e que, por isso, pode ser tratado diretamente como linhas de tabela. Se a própria raiz for um objeto ou array vazio, a chave retornada será uma string vazia, e o valor preservará esse contêiner. Observe que pontos já presentes em um nome de propriedade original não são escapados. Por exemplo, uma propriedade literal chamada user.name produz o mesmo caminho visível que um objeto user aninhado contendo name. Se os dados usarem propriedades com pontos e a identidade do caminho precisar ser reversível, renomeie essas propriedades antes de achatar ou mantenha o JSON original junto do resultado achatado.

Use pares achatados em fluxos de dados

Os pares achatados funcionam bem como representação intermediária. Uma automação de planilha pode colocar chaves em uma coluna e valores em outra; uma rotina de ingestão pode pivotar caminhos selecionados em uma linha larga; e uma ferramenta de comparação pode indexar os pares por chave antes de verificar dois documentos. Segmentos numéricos de arrays também deixam registros repetidos explícitos, em vez de misturar valores de elementos diferentes. Como a operação não faz solicitações de rede e não usa valores aleatórios, horários nem inferência de modelos, textos JSON idênticos sempre produzem saídas idênticas. JSON inválido falha sem devolver resultado parcial, e JSON escalar válido falha porque não atende ao contrato de objeto ou array. O preço da API é US$ 0,002 por item, enquanto o executor do navegador pode rodar localmente a mesma lógica determinística. Em documentos muito grandes, considere um pipeline de streaming ou específico do esquema, pois o achatamento cria uma linha para cada folha primitiva ou contêiner vazio do documento inteiro.