JSON vs XML: por que las APIs modernas casi siempre eligen JSON
2024-06-25
Hace anos SOAP y XML dominaban la integracion empresarial; hoy la mayoria de APIs publicas documentan JSON. Aqui explicamos por que y cuando XML todavia tiene sentido.
Sintaxis y legibilidad
JSON es minimalista: objetos, arreglos y escalares, sin etiquetas de cierre ni namespaces para payloads API tipicos.
XML destaca en modelos documentales con contenido mixto y atributos; para bolsas de campos, JSON suele ser mas simple.
{ "id": 1001, "name": "Alice", "roles": ["admin"] }<user><id>1001</id><name>Alice</name><roles><role>admin</role></roles></user>Tamano del payload
La sobrecarga de etiquetas hace XML mas grande para los mismos datos; la compresion ayuda, pero los bytes importan en movil.
Parsing y experiencia de desarrollo
JSON.parse es nativo en navegador y Node; XML requiere parsers extra y mas complejidad mental con XPath.
Esquemas y tooling
XSD vs JSON Schema: ambos sirven, pero ejemplos OpenAPI y modelos TS/Go/Python suelen asumir JSON.
Cuando XML aun encaja
SOAP heredado, industrias reguladas y estandares documentales (OOXML, SVG). Para APIs web nuevas, JSON por defecto.
Consejos de migracion
Endpoints nuevos en JSON; coloca XML antiguo detras de adaptadores con una linea de tiempo de deprecacion. Valida payloads durante la migracion.