Aplanar JSON anidado a tabla con claves de notación de puntos

Cada propiedad anidada recibe una ruta con notación de puntos y las posiciones de los arrays se transforman en segmentos numéricos, por lo que un identificador de pedido puede localizarse siempre como orders.0.id. El resultado sirve para hojas de cálculo, tablas de preparación de bases de datos, registros, herramientas de mapeo y cualquier flujo que necesite rutas predecibles en lugar de estructuras anidadas. El proceso es determinista, conserva los tipos JSON y rechaza con un error claro el JSON mal formado o una raíz escalar.

Convierta estructuras anidadas en rutas predecibles

El JSON anidado resulta ideal para las API porque mantiene juntos los valores relacionados, pero muchas herramientas de informes e importación esperan una secuencia plana de campos. Esta capacidad recorre cada propiedad de objeto y cada elemento de array, y une todos los segmentos con un punto. Un valor guardado dentro de un objeto customer y una propiedad name pasa a ser customer.name. El primer elemento de un array orders se identifica mediante orders.0, de modo que su identificador se convierte en orders.0.id. Cada hoja se devuelve como una fila con clave y valor, lo que facilita mostrar, filtrar o transformar la salida en columnas. El recorrido respeta el orden presente en el JSON analizado y ofrece resultados estables para la misma entrada. Las cadenas siguen siendo cadenas, los números siguen siendo números, los booleanos siguen siendo booleanos y null se conserva. Los objetos y arrays vacíos se emiten como valores en vez de desaparecer, por lo que la salida plana registra que esas rutas existían en el documento original.

Prepare la entrada e interprete la salida

Proporcione el documento JSON completo como texto en el campo json. Su raíz debe ser un objeto o un array. Este requisito evita una clave vacía ambigua para cadenas, números, booleanos o null independientes. Los nombres de las propiedades del objeto se usan exactamente como se proporcionan, mientras que los índices de array se escriben como segmentos numéricos desde cero. La respuesta contiene pairs, un array cuyas entradas incluyen los campos key y value y que, por tanto, puede tratarse directamente como filas de una tabla. Si la propia raíz es un objeto o array vacío, la clave devuelta es una cadena vacía y el valor conserva ese contenedor. Tenga en cuenta que los puntos existentes en un nombre de propiedad original no se escapan. Por ejemplo, una propiedad literal llamada user.name genera la misma ruta visible que un objeto user anidado con name. Si sus datos contienen propiedades con puntos y necesita rutas reversibles, cambie esos nombres antes de aplanar o conserve el JSON original junto al resultado plano.

Utilice los pares planos en flujos de datos

Los pares aplanados funcionan bien como representación intermedia. Una automatización de hoja de cálculo puede colocar las claves en una columna y los valores en otra; una tarea de ingesta puede convertir rutas seleccionadas en columnas de una fila ancha; y una herramienta de comparación puede indexar los pares por clave antes de revisar dos documentos. Los segmentos numéricos de arrays también distinguen los registros repetidos, en lugar de mezclar valores de elementos diferentes. Como la operación no realiza solicitudes de red ni utiliza valores aleatorios, marcas de tiempo o inferencia de modelos, un texto JSON idéntico produce siempre la misma salida. El JSON no válido falla sin devolver un resultado parcial, y el JSON escalar válido falla porque no cumple el contrato de objeto o array. El precio de la API es de $0.002 por elemento, mientras que el ejecutor del navegador puede usar localmente la misma lógica determinista. Para documentos muy grandes, valore un flujo de transmisión o específico del esquema, ya que el aplanado crea una fila por cada hoja primitiva o contenedor vacío.