JSON vs. XML: Warum moderne APIs fast immer JSON wählen

2024-06-25

SOAP und XML dominierten früher die Enterprise-Integration; heute setzen öffentliche API-Dokus überwiegend auf JSON. Hier ist warum und wann XML dennoch passt.

Syntax und Lesbarkeit

JSON ist minimal: Objekte, Arrays und Skalare, ohne schließende Tags oder Namespaces für typische API-Payloads.

XML ist stark bei Dokumentmodellen mit Mixed Content und Attributen, JSON ist für Feldsammlungen meist einfacher.

JSON
{ "id": 1001, "name": "Alice", "roles": ["admin"] }
XML-Äquivalent
<user><id>1001</id><name>Alice</name><roles><role>admin</role></roles></user>

Payload-Größe

Tag-Overhead macht XML für dieselben Daten größer; Komprimierung hilft, aber Bytes zählen weiterhin auf Mobilgeräten.

Parsing und Developer Experience

Native JSON.parse in Browsern und Node, während XML zusätzliche Parser und XPath-Komplexität mitbringt.

Schemas und Tooling

XSD vs. JSON Schema: beides funktioniert, aber OpenAPI-Beispiele und TS/Go/Python-Modelle sind standardmäßig JSON-zentriert.

Wann XML weiter passt

Legacy-SOAP, regulierte Branchen und Dokumentstandards wie OOXML oder SVG. Für neue Web-APIs ist JSON der Standard.

Migrationstipps

Neue Endpunkte in JSON bereitstellen, alte XML-Endpoints über Adapter mit klarer Deprecation-Timeline weiterführen. Während der Migration Payloads validieren.