JSON vs XML : pourquoi les API modernes choisissent presque toujours JSON
2024-06-25
SOAP et XML dominaient l'integration entreprise ; aujourd'hui la documentation d'API publique est majoritairement en JSON. Voici pourquoi, et quand XML reste utile.
Syntaxe et lisibilite
JSON est minimal : objets, tableaux, scalaires ; pas de balises fermantes ni namespaces pour les payloads API habituels.
XML brille pour les modeles documentaires avec contenu mixte et attributs ; JSON reste plus simple pour des structures de champs.
{ "id": 1001, "name": "Alice", "roles": ["admin"] }<user><id>1001</id><name>Alice</name><roles><role>admin</role></roles></user>Taille de payload
Le surcout des balises rend souvent XML plus volumineux a donnees egales ; la compression aide mais les octets comptent en mobile.
Parsing et experience dev
JSON.parse est natif dans les navigateurs et Node ; XML demande des parseurs supplementaires et plus de complexite mentale avec XPath.
Schemas et outils
XSD vs JSON Schema : les deux fonctionnent, mais les exemples OpenAPI et modeles TS/Go/Python supposent souvent JSON.
Quand XML reste adapte
SOAP legacy, secteurs reglementes, standards documentaires (OOXML, SVG). Pour de nouvelles API web, JSON par defaut.
Conseils de migration
Nouveaux endpoints en JSON ; gardez l'ancien XML derriere des adaptateurs avec calendrier de deprecation. Validez les payloads pendant la migration.