JSON a CSV

El desajuste entre documentos y filas

El JSON está construido para anidar: un pedido puede contener un objeto de cliente, que a su vez contiene una dirección, que a su vez contiene un arreglo de pedidos anteriores, cada uno con sus propias líneas de producto. El CSV no tiene forma de expresar eso; es, en esencia, una cuadrícula de filas y columnas, un registro plano por línea. Quien haya intentado programar esta conversión a mano conoce el fallo habitual: una herramienta ingenua serializa la parte anidada y vuelca un bloque de llaves escapadas en una sola celda, lo cual técnicamente "funciona" pero produce una hoja que nadie puede filtrar ni ordenar.

Cómo se comporta realmente el aplanado

Envíe su arreglo o documento JSON a POST /data/json-to-csv y los objetos anidados se despliegan en columnas con notación de punto, de modo que address.city queda junto a address.country en lugar de enterrado dentro de un solo bloque, mientras que los arreglos de valores simples se combinan de forma predecible y los arreglos de objetos se expanden según la forma de sus datos, así que las líneas de un pedido se convierten en columnas legibles en vez de una cadena opaca. Las cabeceras se derivan directamente de la estructura de su JSON, así que el mapeo hacia la columna de salida queda claro para quien abra el archivo después.

Por qué esto sigue importando cuando todo es una API

Sería fácil suponer que el CSV es cosa del pasado ahora que la mayoría de los sistemas intercambian JSON de forma nativa, pero la hoja de cálculo sigue siendo la interfaz en la que confían las personas no técnicas. Finanzas concilia en hojas de cálculo, operaciones construye tablas dinámicas a partir de ellas, y muchas herramientas de negocio todavía solo aceptan CSV como formato de importación. Convertir la salida de una API a CSV tiene menos que ver con la tecnología y más con encontrarse con la gente donde ya trabaja.

Manejo de registros irregulares sin romper la cuadrícula

Las colecciones de JSON reales rara vez son perfectamente uniformes: un pedido tiene un campo de descuento y el siguiente no, un cliente tiene tres teléfonos y otro no tiene ninguno. La conversión reconcilia las formas distintas entre registros en una sola fila de cabecera consistente, rellenando los campos ausentes en lugar de desplazar columnas, que es la forma más común en que los conversores hechos a mano corrompen una hoja en silencio.

Encaje en reportes automatizados

Como la tarea corre de forma asíncrona, funciona bien al final de un pipeline de reportes: extrae registros desde la API de su aplicación, convierte el JSON resultante a CSV aquí, y entrega el archivo directamente a la bandeja de un analista o a una unidad compartida sin que un script tenga que vigilar la transformación. Recibe un task_id de inmediato y el CSV llega por webhook, listo para adjuntar o reenviar.