Comparer deux versions d’un format et voir ce qui casse
Placez le format actuel à gauche et le nouveau à droite. Chaque changement est listé et marqué comme cassant ou sans risque, et vous pouvez tester de vrais messages contre la nouvelle version.
Chargement de l’outil…
Ce qui compte comme un changement cassant
Un changement est cassant quand un émetteur qui respectait l’ancienne version peut être refusé par la nouvelle.
| Changement | Casse des envois ? |
|---|---|
| Longueur maximale réduite, ou ajoutée là où il n’y en avait pas | Oui |
| Longueur maximale augmentée ou supprimée | Non |
| Champ facultatif devenu obligatoire | Oui |
| Nouveau champ obligatoire | Oui |
| Nouveau champ facultatif | Non |
| Valeur autorisée retirée | Oui |
| Valeur autorisée ajoutée | Non |
| Type modifié (sauf d’entier à nombre) | Oui |
| Format de date modifié | Oui |
| Champ supprimé alors que les champs inconnus sont refusés | Oui |
| Les champs inconnus passent d’acceptés à refusés | Oui |
D’une liste de changements à un nombre d’échecs
Une liste de changements dit ce qui pourrait casser. De vrais messages disent ce qui cassera. Collez dans la zone facultative un fichier ou un message qui passe aujourd’hui : l’outil compte combien de ses enregistrements la nouvelle version refuserait, et les liste.
Un point de contrôle le fait avec son propre journal : avant d’enregistrer une nouvelle version, il indique combien des derniers messages acceptés ne passeraient plus.
Questions
- Quels formats puis-je comparer ?
- Deux formats tels que ce site les utilise : une liste de champs avec un type et des limites. Construisez chaque côté dans le tableau, ou collez-le en JSON.
- Puis-je comparer deux fichiers JSON Schema ou OpenAPI ?
- Non. L’outil compare les formats simples utilisés ici. Pour une description OpenAPI, utilisez un outil de comparaison OpenAPI.
- Quelque chose est-il envoyé ?
- Non. Les formats et les messages d’exemple restent dans votre navigateur.