Schémas et types

comparateur de schémas JSONLire le risque dans chaque sens

Collez deux schémas JSON ou chargez une paire d’exemples, puis indiquez le producteur et le consommateur des données.

comparateur de schémas JSON

Ancien schéma JSON

Nouveau schéma JSON

Les deux schémas restent dans ce navigateur. Aucune saisie ni URL de référence n’est envoyée.

Options de validation

Prêt pour un contrôle manuel.

Différences

Une application peut conserver des enregistrements anciens tout en déployant un nouveau lecteur. Le comparateur de schémas JSON examine les contraintes acceptées plutôt que les seules lignes de texte.

Si les nouvelles données doivent être lues par un ancien client, inversez le sens. Le comparateur de schémas JSON distingue une propriété facultative d’un nouveau champ obligatoire.

Pourquoi ce comparateur de schémas JSON ?

Une même modification n’a pas le même effet dans les deux sens.

Nommer le flux de données

Par défaut, les anciennes données vont vers le nouveau schéma. Le sens inverse montre les risques pour un consommateur resté sur l’ancien contrat.

Deux arbres de schéma portent des flèches opposées; un seul flux affiche un repère de risque.

Garder les inconnues visibles

Le comparateur de schémas JSON signale les chemins de $ref et des règles combinées pour un examen humain, sans annoncer une compatibilité prouvée.

Une branche de référence sur deux cartes de schéma est accompagnée d’un repère de vérification.

Définir le sens avant la conclusion

01

Choisir qui produit les données

Le réglage initial est anciennes données → nouveau schéma. Inversez-le si un client non mis à jour doit lire des données récentes.

02

Suivre les pointeurs

Un nom requis apparaît sous /required; un changement de type se trouve dans /properties. Le filtre de risques conserve aussi les éléments à vérifier.

03

Relancer avant de partager

Une saisie ou un changement de sens périme le rapport et bloque l’export. Ctrl/Cmd+Entrée lance une nouvelle comparaison.

Signaux utiles pour une révision

Obligation et type

Comparer des schémas JSON demande de séparer required et type: un champ devenu obligatoire peut écarter un ancien enregistrement.

Enum et limites

La compatibilité des schémas dépend aussi des valeurs enum et des bornes de longueur, de quantité ou de nombre. L’ordre des valeurs enum ne crée pas de changement.

Rapport traçable

Le diff de schéma JSON indique le pointeur, la valeur avant et après et le niveau de risque. Le rapport complet est téléchargeable en JSON.

Ce que le rapport ne démontre pas

Pas de preuve universelle
Le comparateur de schémas JSON ne conclut que sur les règles prises en charge. Il ne prouve ni tous les cas possibles ni la logique de votre application.
Références non résolues
$ref, oneOf et les autres combinaisons restent à examiner. Aucun lien externe n’est chargé et aucune boucle locale n’est développée.
Définir ne rend pas obligatoire
Une entrée nouvelle sous properties n’impose pas sa présence. Les champs obligatoires relèvent de required; additionalProperties peut aussi peser sur le risque.

Questions sur le comparateur de schémas JSON

Quels modes de différence ce vérificateur de schéma JSON prend-il en charge ?

Il montre les écarts de structure et de contraintes entre deux versions, avec une lecture par sens de circulation des données.

Le mode normalisé ignore-t-il l'ordre des clés du schéma ?

Oui. L’ordre des clés, ainsi que l’ordre de required ou enum, est ignoré lorsqu’il ne change pas leur sens.

Peut-il aider avec les schémas lourds en $ref ?

Le chemin $ref est indiqué, mais sa cible n’est ni résolue localement ni chargée depuis le réseau.

En quoi un diff JSON diffère-t-il d’un diff texte ?

Un diff JSON porte sur des valeurs; un diff texte compare des caractères. Ici, certaines contraintes du schéma reçoivent aussi un signal de risque.

Mes données sont-elles envoyées, et jusqu’à quelle taille ?

Non. Les données restent dans le navigateur. Chaque entrée est limitée à 500 000 caractères, pour un total de 1 000 000.

Un cas de schéma mérite vérification ?

Essayer le comparateur de schémas JSON

Placez les deux versions côte à côte, choisissez le sens et conservez le rapport. Le comparateur de schémas JSON fournit des indices vérifiables pour la revue.