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

¿Qué es JSON?

JSON es un formato basado en texto para representar datos estructurados. Se derivó de la sintaxis de literales de objeto de JavaScript, pero es independiente del lenguaje: casi todos los lenguajes de programación pueden leer y producir JSON.

Fue introducido por Douglas Crockford a principios de los 2000 como una alternativa más simple a XML. Hoy es un estándar internacional (ECMA-404 / RFC 8259) y el formato de carga útil predeterminado para las APIs REST, GraphQL y la mayoría de los servicios web.

Conceptos básicos de la sintaxis de JSON

JSON tiene dos estructuras: objetos (mapas de clave/valor entre llaves) y arrays (listas ordenadas entre corchetes). Las claves deben ser cadenas entre comillas dobles; los valores pueden ser cualquiera de los seis tipos de datos.

{
  "name": "Alice",
  "age": 30,
  "active": true,
  "roles": ["admin", "editor"],
  "address": {
    "city": "San Francisco",
    "zip": "94102"
  },
  "metadata": null
}

Ten en cuenta las reglas: las claves usan comillas dobles (las comillas simples no son válidas), los elementos se separan con comas y no hay coma final después del último elemento.

Los seis tipos de datos

JSON admite exactamente seis tipos de datos. Entenderlos es la base para trabajar con cualquier JSON.

string: texto entre comillas dobles, p. ej. "hello". number: enteros o decimales, p. ej. 42 o 3.14. boolean: true o false (sin comillas). null: un valor vacío explícito. object: un mapa de pares clave/valor entre { }. array: una lista ordenada entre [ ].

Eso es todo. JSON no tiene fechas, ni funciones, ni undefined: estos deben codificarse como cadenas o bien omitirse. Este minimalismo es lo que hace que JSON sea tan universalmente interoperable.

Dónde se usa JSON

APIs: casi todos los endpoints REST y GraphQL intercambian JSON. Configuración: package.json, tsconfig.json e innumerables archivos de configuración de herramientas son JSON. Bases de datos: MongoDB, CouchDB y JSONB de PostgreSQL almacenan documentos como JSON. Intercambio de datos: el formato de transferencia entre servidor y navegador en las aplicaciones web modernas.