JSON y XML son herramientas de intercambio de información estructurada, pero tienen modelos y reglas diferentes. Ninguno asegura por sí solo que un documento sea correcto para tu aplicación. Antes de importarlo a una herramienta o enviarlo a una API, hay que distinguir tres preguntas: ¿tiene sintaxis válida?, ¿cumple el esquema esperado?, ¿sus valores tienen sentido?
JSON: objetos, listas y tipos
JSON representa objetos con propiedades, arrays, números, cadenas, booleanos y null. Las claves se escriben entre comillas dobles y los comentarios no forman parte de la sintaxis estándar. Una fecha normalmente se transmite como cadena y requiere una convención. Parsear un JSON sin error no demuestra que contenga todas las propiedades obligatorias ni que cada número esté en un rango permitido.
XML: elementos y atributos
XML utiliza elementos anidados y atributos para representar datos. Los caracteres como & y < requieren escape dentro del contenido, y el documento debe estar bien formado. Los formatos XML suelen definir reglas adicionales mediante esquemas. Un parser inseguro que permita entidades externas puede exponer recursos o causar problemas; el procesamiento de datos no confiables requiere una configuración adecuada.
Errores frecuentes en integraciones
No hay equivalencia automática entre todo XML y todo JSON. Los atributos, el contenido mixto y el orden de elementos pueden necesitar reglas específicas. También hay diferencias entre un entero grande, un decimal y una cadena que contiene cifras. Antes de convertir diseña un mapeo documentado y valida unos cuantos ejemplos que tengan campos vacíos, caracteres acentuados y listas.
Versión, migración y compatibilidad
Una API puede cambiar con el tiempo. Para evitar rupturas, documenta nombres, tipos y significado de propiedades; incorpora versiones y pruebas de validación de contrato. Si una aplicación añade un campo nuevo, decide cómo se comporta el consumidor antiguo. Una exportación reversible debe preservar significados, no solamente generar un texto que parezca estructurado.
Práctica paso a paso
- Abre ejemplo_api.json y revisa qué valores son números y cuáles cadenas.
- Edita una copia para eliminar una comilla y comprueba que un parser JSON la rechaza.
- Abre ejemplo_configuracion.xml y revisa elementos y atributos.
- Introduce un & sin escaparlo en una copia XML y comprueba qué ocurre al validarla.
- Escribe tres reglas propias de esquema: una clave obligatoria, un tipo y un rango permitido.
Errores habituales que conviene evitar
- Pensar que JSON válido significa datos correctos para cualquier API.
- Usar eval para interpretar JSON o activar entidades externas con XML no confiable.
- Convertir datos sin definir cómo representar atributos, fechas o números.
Actividad razonada
Archivos de práctica
Los siguientes materiales son originales de AppInitDev y utilizan información ficticia o señales generadas. Puedes descargarlos para reproducir el ejercicio sin exponer archivos personales.
Fuentes y límites
Los enlaces respaldan los conceptos generales tratados, no garantizan que una aplicación de terceros o cada dispositivo admita todas las variantes. Las pruebas propuestas deben realizarse y documentarse antes de publicar resultados.