Blog de JSONLynx

JSON (JavaScript Object Notation) es un formato ligero de intercambio de datos que se ha convertido en el estándar de facto para APIs web y comunicación entre sistemas. Pero, ¿por qué es tan popular?

Historia de JSON

JSON fue especificado por primera vez por Douglas Crockford a principios de los años 2000. Aunque deriva de JavaScript, es un formato de texto completamente independiente del lenguaje, lo que lo hace perfecto para el intercambio de datos entre diferentes tecnologías.

Características Principales

• Ligero: Menos verbose que XML, más fácil de leer y escribir
• Auto-descriptivo: Los datos están estructurados de forma comprensible
• Independiente del lenguaje: Soportado por prácticamente todos los lenguajes de programación
• Fácil de parsear: Los parsers JSON son rápidos y eficientes

Estructura Básica

{
  "nombre": "Juan Pérez",
  "edad": 30,
  "email": "[email protected]",
  "habilidades": ["JavaScript", "Python", "SQL"],
  "activo": true
}

Usos Comunes de JSON

1. APIs REST: El formato estándar para respuestas de APIs web
2. Archivos de configuración: package.json, tsconfig.json, settings.json
3. Almacenamiento de datos: NoSQL databases como MongoDB usan JSON
4. Comunicación en tiempo real: WebSockets, Server-Sent Events
5. Intercambio de datos: Entre diferentes servicios y microservicios

Trabajar con JSON puede ser frustrante cuando encuentras errores difíciles de detectar. Aquí están los errores más comunes y cómo evitarlos:

1. Comas finales (Trailing Commas)

Error: JSON no permite comas después del último elemento en arrays u objetos.

// ❌ Incorrecto
{
  "nombre": "Juan",
  "edad": 30,  // ← Esta coma causa error
}

// ✅ Correcto
{
  "nombre": "Juan",
  "edad": 30
}

2. Comillas simples en lugar de dobles

JSON solo acepta comillas dobles para strings y nombres de propiedades.

// ❌ Incorrecto
{'nombre': 'Juan'}

// ✅ Correcto
{"nombre": "Juan"}

3. Claves sin comillas

A diferencia de JavaScript, en JSON todas las claves deben estar entre comillas dobles.

// ❌ Incorrecto
{nombre: "Juan"}

// ✅ Correcto
{"nombre": "Juan"}

4. Comentarios

JSON no soporta comentarios. Si necesitas documentación, considera usar un campo especial o archivos separados.

5. Tipos de datos no permitidos

• ❌ undefined
• ❌ NaN
• ❌ Infinity
• ❌ Funciones
• ❌ Dates (deben ser strings)

6. Números con ceros a la izquierda

// ❌ Incorrecto
{"codigo": 0123}

// ✅ Correcto
{"codigo": 123}
// o como string si es necesario
{"codigo": "0123"}

7. Strings multilinea

JSON no permite saltos de línea directos en strings. Usa \n.

// ❌ Incorrecto
{
  "descripcion": "Primera línea
Segunda línea"
}

// ✅ Correcto
{
  "descripcion": "Primera línea\nSegunda línea"
}

8. Arrays o objetos vacíos con formato incorrecto

// ❌ Incorrecto
{"items": [,]}
{"config": {,}}

// ✅ Correcto
{"items": []}
{"config": {}}

9. Duplicación de claves

Aunque técnicamente es JSON válido, duplicar claves puede causar comportamientos inesperados.

10. Encoding incorrecto

JSON debe usar UTF-8. Caracteres especiales no escapados pueden causar problemas.

Tanto JSON como XML son formatos populares para el intercambio de datos, pero tienen diferencias significativas. Veamos cuándo usar cada uno.

Comparación Visual

El mismo dato en JSON:

{
  "persona": {
    "nombre": "Ana García",
    "edad": 28,
    "ciudad": "Madrid"
  }
}

El mismo dato en XML:

<?xml version="1.0" encoding="UTF-8"?>
<persona>
  <nombre>Ana García</nombre>
  <edad>28</edad>
  <ciudad>Madrid</ciudad>
</persona>

Ventajas de JSON

• ✅ Más conciso y fácil de leer
• ✅ Parsing más rápido
• ✅ Tamaño de archivo menor (~30% más pequeño)
• ✅ Mapeo directo a objetos en la mayoría de lenguajes
• ✅ Mejor para APIs REST
• ✅ Soporte nativo en navegadores

Ventajas de XML

• ✅ Soporta atributos en elementos
• ✅ Validación con XSD (XML Schema)
• ✅ Comentarios permitidos
• ✅ Mejor para documentos complejos
• ✅ Transformaciones con XSLT
• ✅ Namespaces para evitar conflictos

¿Cuándo usar JSON?

• APIs REST modernas
• Aplicaciones web y móviles
• Configuraciones simples
• Comunicación entre microservicios
• Almacenamiento en NoSQL

¿Cuándo usar XML?

• Sistemas legacy/empresariales
• Documentos complejos (SOAP, SVG)
• Cuando necesitas validación estricta
• Procesamiento de documentos
• Configuraciones Android