Formato JSON: qué es, cómo funciona y cuándo usarlo
JSON representa datos mediante objetos, matrices, cadenas, números, booleanos y valores nulos organizados en una jerarquía legible por personas y aplicaciones.
- Extensión
- .json, .jsonl o .ndjson
- Tipo MIME
- application/json
- Identificación
- Texto Unicode que comienza normalmente con { o [; JSONL contiene un valor por línea
- Referencia
- RFC 8259 y ECMA-404
01
Objetos, matrices y valores JSON
Un objeto JSON agrupa pares de nombre y valor entre llaves; una matriz conserva una secuencia entre corchetes. Los valores pueden ser cadenas, números, booleanos, null, otros objetos o matrices. JSON no admite comentarios, funciones, fechas nativas ni valores especiales como NaN o Infinity.
El orden de los elementos de una matriz es significativo. El orden de las propiedades de un objeto no debe usarse como sustituto de un esquema. Para convertir a CSV, la matriz que contiene registros suele transformarse en filas y la unión de sus propiedades en columnas.
02
JSONL y NDJSON para colecciones grandes
JSON Lines y NDJSON almacenan un valor JSON independiente en cada línea. Esta organización es habitual en registros, exportaciones y procesamiento por lotes porque permite leer entradas sucesivamente sin envolver toda la colección en una matriz.
No existe un único tipo de medio universal usado por todos los productores de JSONL. Conviene conservar UTF-8, una línea por registro y evitar saltos de línea sin escapar dentro de cada valor.
03
Qué se simplifica al pasar de JSON a CSV
CSV es una tabla plana y no conserva por sí mismo objetos, listas ni un esquema de tipos. Un conversor debe decidir una colección de filas, aplanar propiedades anidadas o serializarlas dentro de una celda y crear celdas vacías cuando una propiedad no existe en todos los registros.
Las hojas de cálculo pueden reinterpretar identificadores, fechas, números extensos y textos que parecen fórmulas. Por eso el resultado debe escapar delimitadores y comillas, declarar una codificación adecuada y neutralizar fórmulas en valores de texto cuando se abrirá en Excel u otra aplicación similar.
Cuándo conviene usar JSON
- Respuestas de API, configuraciones e intercambio de datos entre aplicaciones.
- Registros con propiedades opcionales, objetos anidados o listas internas.
- Datos que necesitan conservar nombres, tipos básicos y jerarquía.
- Flujos JSONL o NDJSON donde cada línea representa un evento independiente.
Cuándo elegir otra opción
- Tablas simples que usuarios no técnicos deben editar directamente en una hoja de cálculo.
- Documentos cuyo objetivo principal es conservar una presentación visual paginada.
- Números de precisión arbitraria si el consumidor solo admite el tipo Number de JavaScript.
Lista de control para validar un JSON
- El documento contiene exactamente un valor JSON válido o un valor válido por línea en JSONL.
- Las claves, cadenas, barras invertidas y caracteres de control están escapados correctamente.
- La colección que representa las filas está identificada antes de convertir a una tabla.
- Los identificadores extensos, fechas y valores nulos se revisan en la aplicación de destino.
Procesamiento local
Herramientas disponibles para JSON
Fuentes técnicas oficiales
La ficha se contrastó con las especificaciones y registros enlazados a continuación.