Qué es JSON

Los dos contenedores: objetos y arrays

Todo en JSON se construye a partir de dos estructuras. Un objeto es un conjunto sin orden de pares clave/valor envueltos en llaves — las claves son siempre cadenas, los valores pueden ser cualquier valor JSON y los pares se separan con comas. Un array es una lista ordenada de valores envuelta en corchetes, y sus valores pueden ser de cualquier mezcla de tipos.

{
  "name": "Ada Lovelace",
  "born": 1815,
  "mathematician": true
}

[
  "analytical engine",
  1843,
  null
]

Los seis tipos de datos

Cuatro son escalares — string, number, boolean y null — y dos son los contenedores de arriba. Las reglas que sorprenden a quien llega son pocas pero estrictas: las cadenas van siempre entre comillas dobles (las comillas simples no son válidas), los números no llevan comillas y no se pueden escribir en hexadecimal, los booleanos son exactamente los tokens en minúscula true y false, y null es un valor en sí mismo que significa vacío a propósito.

Escapes: qué puede vivir dentro de una cadena

Dentro de una cadena, hay dos caracteres que deben escaparse dondequiera que aparezcan: las comillas dobles (como \") y la barra invertida (como \\). Existen seis escapes más para caracteres de control — \n salto de línea, \t tabulador, \r retorno de carro, \b retroceso, \f salto de página, y \/ para la barra diagonal, que es legal pero opcional. Cualquier otro carácter puede aparecer literalmente como UTF-8, o como un escape \uXXXX de su punto de código Unicode — ambas formas significan exactamente la misma cadena para un parser.

"path": "C:\\Users\\ada"
"quote": "she said \"hi\""
"emoji": "\ud83d\ude00"

path:   C:\Users\ada
quote:  she said "hi"
emoji:  😀

Espacios en blanco, formato y por qué existe el formateo

Entre la puntuación estructural, JSON permite exactamente cuatro caracteres de espacio en blanco: espacio, tabulador, salto de línea y retorno de carro. Esa permisividad es la que hace posible dar formato — el mismo documento puede ser una línea ilegible en el cable y un árbol indentado en tu editor, y ambos son byte a byte los mismos datos para un parser. Dar formato no cambia nada del significado, y por eso la herramienta formateadora es segura de ejecutar sobre cualquier payload y el JSON minificado es la elección estándar para el transporte.

• Sin comentarios: RFC 8259 eliminó los comentarios a propósito, tras divergencias reales entre parsers. JSONC es la extensión no oficial que algunas herramientas aceptan.
• Sin comas finales: [1, 2, 3,] no es válido, por amigable que parezca.
• Claves duplicadas: los parsers se quedan con la primera o con la última — RFC 8259 lo deja en manos de las implementaciones, y por eso los duplicados son un fallo incluso donde parsean.
• Cualquier nivel superior: cualquier valor puede ser un documento entero — un array de números es JSON completo.

Dónde se usa JSON — y dónde no

JSON domina tres territorios: los cuerpos de peticiones y respuestas de APIs, la configuración estructurada donde no se echan de menos los comentarios y los datos en reposo en bases de datos documentales. Comparte el cable a regañadientes con dos vecinos — los formatos binarios como protobuf, que ganan en tamaño y velocidad cuando ambos extremos comparten un esquema, y YAML, que gana en editabilidad a mano para la configuración de ops. Entender JSON a fondo no es, por tanto, una habilidad entre muchas; es el prerrequisito para leer a esos dos vecinos, porque YAML 1.2 parsea JSON y la mayoría de los esquemas binarios se documentan con ejemplos JSON.