JSON
JavaScript Object Notation
¿Qué es JSON?
- Formato para el intercambio de datos entre programas
- Texto fácil de leer para las personas
- Se representa en pares 'nombre: valor'
Lo que más se rompe al pasar datos es saber 'qué valor está en qué posición'. Si se intercambian en Excel o CSV, en cuanto se corre una columna, el nombre del destinatario pasa a tener un número de teléfono. Como JSON pone una etiqueta a cada valor, aunque cambie el orden de los campos o se añada uno nuevo en medio, el resto se sigue leyendo bien. Es como llevar el manual dentro de los propios datos, así que quien los recibe entiende qué es cada cosa sin instrucciones adicionales. Buena parte del tiempo que se ahorra en las reuniones de integración se va en ponerse de acuerdo sobre el orden y la posición de los campos.
Los valores que puede contener son solo seis: texto, números, verdadero/falso, valor vacío (null), arreglos que enumeran varios elementos ([ ]) y objetos, que son pares nombre-valor ({ }). Lo clave es anidar arreglos y objetos, con lo que se representa directamente una estructura como 'un pedido con tres productos, cada uno con su cantidad y precio unitario'. En Excel, esa información obligaría a repetir el número de pedido en tres filas; en JSON queda en un solo bloque. La diferencia práctica frente a los formatos tabulares está en que puede representar jerarquías que una sola tabla no puede contener.
Sin embargo, no hace falta convertir todos los datos a JSON. Una tabla simple con cientos de miles de filas es más práctica en CSV, que ocupa menos espacio y se abre directamente en Excel. Frente a escribir lo mismo en XML, la ventaja de JSON es que no repite etiquetas y, por tanto, ocupa menos caracteres; y los datos que se acumulan sin parar, como los registros, se manejan en JSONL, con un registro por línea. Si quiere fijar el nombre y el tipo de cada campo, adjunte un JSON Schema a la especificación. El 'ejemplo de respuesta' de la documentación de una API suele ser precisamente este bloque.
En la práctica, la mayoría de los errores vienen de la sintaxis. Basta una coma de más o cambiar las comillas dobles por simples para que el archivo entero deje de poder leerse. Como no existe el caso de «una celda rara y el resto bien» que se ve en Excel, una respuesta de 500 registros puede quedar en cero por un solo carácter. También es frecuente olvidar que no se pueden poner comentarios: en un caso, al añadir una explicación a un archivo de configuración escrito por IA, el servicio dejó de arrancar. Las fechas y los ceros a la izquierda también dan problemas. JSON no tiene tipo de fecha, así que hay que acordar de antemano escribirlas como texto, como «2026-03-01»; y si el código postal 06234 se envía como número, llega como 6234. Además, el texto en coreano se rompe si no se guarda en UTF-8.
Jaryong KooDoctor en marketing y referente en análisis de datos con IA y en marca personal
John KimAutor de «Diseño de marketing B2B» y CEO de Nanum ConsultoríaDouglas Crockford lo popularizó a comienzos de los 2000, al ordenar y especificar la notación de datos de JavaScript. Desde entonces se convirtió en un estándar de intercambio de datos independiente del lenguaje.
Veamos un caso hipotético. La empresa A, distribuidora de productos de uso cotidiano, tiene unos 140 colaboradores y ventas anuales del orden de KRW 30,000,000,000 (≈ US$22,454,100). Organizaba en Excel sus 4,200 pedidos mensuales de la tienda propia y los entregaba a una empresa logística. Dos responsables dedicaban dos horas diarias a alinear columnas, pero aun así los envíos equivocados, con el destinatario y el contacto intercambiados, sumaban de 6 a 7 casos al mes. La empresa logística propuso una integración por API y envió una especificación en JSON, pero como nadie en la empresa podía leerla, se perdieron tres semanas sin avanzar.
- El jefe de equipo Kim, de Negocios en Línea, abrió la especificación, señaló los tres nombres «número de pedido, destinatario y lista de productos» y resumió: «Aquí están tal cual los encabezados de Excel».
- El responsable de integración de la empresa logística explicó que cada pedido queda agrupado en un solo bloque: «La lista de productos es un arreglo que va entre corchetes; si un pedido tiene tres productos, dentro habrá tres bloques».
- El asistente de TI Park, de la empresa A, pegó cinco muestras en un verificador gratuito de JSON: le marcó en rojo dos comas faltantes, y corregirlas le tomó 10 minutos.
- Durante la prueba del tercer día, el código postal 06234 salió como 6234, y el líder de equipo Kim pidió que 'el código postal y el número de empleado se envían como texto, no como números', y se modificó la especificación.
- Ocho semanas después, al terminar la integración, las dos horas diarias que se dedicaban a transferir 4,200 pedidos al mes se redujeron a 10 minutos, y los envíos erróneos por desplazamiento de orden pasaron de 6 o 7 al mes a cero durante dos meses seguidos.