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.

JSON
{ "id": 1001, "name": "Alice", "roles": ["admin"] }
Equivalent XML
<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.