Format Atlas

Guides

Choisir un format de données et de configuration Web

Envisagez JSON pour les échanges machine comme les API, YAML pour les configurations modifiées par des personnes et XML pour les intégrations existantes avec schéma.

Quel format choisir ?

Choisissez selon le rôle de chaque fichier dans votre flux de travail.

  • API Web → JSON
  • Réglages modifiés à la main → YAML
  • Schéma ou contrat existant → XML

Utiliser le format exigé par le destinataire

Tous trois représentent des données structurées, mais diffèrent par syntaxe, commentaires, types et schémas. Vérifiez d'abord le contrat et les outils.

Formats à envisager

JSON

Adapté pour: API et échanges fondés sur JSON

Moins adapté pour: Réglages manuels nécessitant des commentaires

YAML

Adapté pour: Configuration maintenue par des personnes

Moins adapté pour: API acceptant seulement JSON

XML

Adapté pour: Schémas et intégrations XML existants

Moins adapté pour: Nouvelle API simple sans besoin XML

Avant l’export

  • Ne supposez pas que YAML soit un surensemble strict de JSON.
  • Confirmez encodage, types et gestion des schémas avec le destinataire.

Comparaisons associées

JSON vs YAMLJSON est un format texte strict très répandu pour les API et les échanges entre programmes. YAML propose une syntaxe adaptée aux configurations et données structurées modifiées par des personnes. Choisissez selon l’écosystème et le flux.XML vs JSONXML et JSON sont des formats texte pour les données structurées, mais leurs structures et conventions diffèrent.

Guides

Choisir un format d'échange de donnéesCommencez par la spécification du système destinataire. Utilisez JSON pour les API structurées, XML si l'intégration exige son schéma et CSV pour un tableau unique.

Références et spécifications