Fundamentos de sintaxis JSON

Todo documento JSON se construye con un pequeño conjunto de reglas de puntuación. Una vez internalizadas, los archivos inválidos son mucho más fáciles de corregir.

Dos formas estructurales

Los valores JSON son:

• Un objeto — entre { }, con pares clave–valor
• Un array — entre [ ], con una lista ordenada de valores

Un archivo puede ser un solo objeto, un solo array o (menos habitual) un valor primitivo como "hello" o 42.

Objetos: claves y dos puntos

Dentro de un objeto, cada entrada tiene esta forma:

"key": value

Reglas:

• Las claves deben ser cadenas entre comillas dobles
• Dos puntos : separan la clave del valor
• Comas , separan entradas — nunca después de la última

{
  "id": 1,
  "label": "primary"
}

Arrays: valores ordenados

Los arrays listan valores sin claves:

["red", "green", "blue"]

Se permiten tipos mixtos en un array (a diferencia de algunos lenguajes tipados), aunque las APIs suelen mantener arrays homogéneos.

Anidamiento

Objetos y arrays pueden contenerse sin límite:

{
  "users": [
    { "id": 1, "roles": ["admin", "editor"] },
    { "id": 2, "roles": ["viewer"] }
  ]
}

Espacios en blanco

Espacios, tabulaciones y saltos de línea fuera de cadenas son insignificantes. El formato es para humanos; los parsers ignoran el espacio extra.

Formas válidas de nivel superior

Válido	Inválido
{ ... }	{ key: "x" } (clave sin comillas)
[ ... ]	'string' (comillas simples)
"text", 42, true, null	{ "a": 1, } (coma final)

La siguiente lección cubre cada tipo de valor en detalle.