¿Qué es JSON? Una guía para principiantes con ejemplos

Si ha tocado una API, un archivo de configuración o un desarrollo web moderno, ha conocido a JSON. Es el formato de facto para el intercambio de datos entre sistemas: lo suficientemente legible para los humanos y lo suficientemente estricto para las máquinas. A continuación se ofrece un recorrido para principiantes sobre qué es y cómo trabajar con él.

Qué es JSON

JSON significa notación de objetos JavaScript. A pesar del nombre, es independiente del lenguaje: prácticamente todos los lenguajes de programación pueden leerlo y escribirlo. Representa datos como pares clave-valor y listas ordenadas, que en conjunto pueden describir casi cualquier dato estructurado.

Un ejemplo sencillo

{
"nombre": "Ada Lovelace",
"edad": 36,
"isMathematician": verdadero,
"idiomas": ["inglés", "francés"]
}

Ese es un objeto con cuatro llaves. Observe los tipos de datos: una cadena entre comillas, un número, un booleano y una matriz de cadenas. JSON admite cadenas, números, valores booleanos, nulos, objetos y matrices: ese es todo el vocabulario.

Las reglas que hacen tropezar a la gente

• Las claves deben estar entre comillas dobles; las comillas simples no son válidas.
• Sin comas finales: una coma después del último elemento lo separa.
• Sin comentarios: JSON no tiene sintaxis de comentarios (una sorpresa frecuente).
• Las cadenas utilizan únicamente comillas dobles, nunca simples.

Estas pequeñas reglas causan la mayoría de los errores "JSON no válidos". La gramática oficial se define en json.org.

Cómo leer y arreglar JSON desordenado

Las API devuelven JSON minimizado en una línea, que es ilegible. Péguelo en nuestro formateador JSON para obtener una salida limpia y con sangría, y un mensaje de error instantáneo que señala cualquier error de sintaxis. Es la forma más rápida de depurar una carga útil con formato incorrecto.

Donde encontrarás JSON

Las respuestas API, los archivos de configuración (como package.json), la carga útil de un JWT, las bases de datos NoSQL y el navegador localStorage usan JSON. Una vez que puedas leerlo cómodamente, se abrirá una gran cantidad de herramientas modernas.

JSON frente a XML

JSON reemplazó en gran medida a XML para las API web porque es más liviano y fácil de leer. XML todavía aparece en algunos contextos empresariales y de documentos, pero para nuevos trabajos web, JSON es el valor predeterminado. Si necesita pasar de un formato a otro, nuestros conversores también se encargan de ello.

Anidamiento: cómo se estructuran los datos reales

Los ejemplos anteriores son planos, pero JSON real anida objetos y matrices uno dentro de otro para modelar datos complejos. Un objeto de usuario puede contener un objeto de "dirección" y una serie de "órdenes", siendo cada orden un objeto. Este anidamiento es lo que permite que JSON describa casi cualquier cosa, pero también es donde la legibilidad se ve afectada, porque el JSON minificado profundamente anidado es imposible de seguir a simple vista. Ahí es exactamente cuando un formateador se gana la vida, sangrando cada nivel para que la estructura sea visible de un vistazo.

Errores JSON comunes y cómo solucionarlos

La mayoría de los errores de "JSON no válido" se deben a unos pocos errores: una coma al final del último elemento, comillas simples en lugar de dobles, una clave sin comillas o un comentario perdido. La parte frustrante es que un carácter incorrecto invalida todo el documento y el mensaje de error puede señalar el lugar equivocado. Pegar en un validador que resalta la línea exacta ahorra tiempo real: señala la coma o cita que el ojo humano pasa por alto.

JSON más allá de las API

Una vez que se sienta cómodo leyendo JSON, lo verá en todas partes: archivos de configuración como package.json, definiciones de infraestructura, bases de datos NoSQL como MongoDB, navegador localStorage y las cargas útiles dentro de JWT. Se ha convertido en la lengua franca del intercambio de datos precisamente porque es simple, legible por humanos y compatible en todas partes. La fluidez en JSON desbloquea silenciosamente una gran cantidad de herramientas modernas.

Conclusión

JSON es una forma sencilla y universal de representar datos estructurados con claves, valores y matrices. Aprenda un puñado de reglas estrictas (comillas dobles, sin comas finales, sin comentarios) y apóyese en un formateador para validarlo y ordenarlo. Es uno de los formatos más útiles para dominarlo. Para obtener más ayuda cotidiana, consulte nuestro kit de herramientas para desarrolladores web.