Guides pratiques
Comparer deux réponses JSON d’API avant le déploiement
Méthode sûre pour comparer des réponses JSON, formater les entrées, trouver les clés modifiées et éviter les pièges du diff texte.
Mis à jour 2026-06-03 · 6 min de lecture
Pourquoi le diff texte peut tromper
Les réponses API changent souvent les espaces, l’ordre des propriétés ou le format sans changer la donnée. Un diff texte peut donc exagérer le changement.
JSON Diff formate le JSON valide puis compare une structure normalisée, ce qui convient mieux aux régressions API.
Flux avant déploiement
Récupérez les réponses production et staging, puis retirez tokens, sessions et données personnelles.
Validez, formatez et comparez. Regardez les clés dont le sens change, pas seulement les timestamps ou requestId.
- Valider la syntaxe avant comparaison.
- Normaliser le format pour limiter le bruit des espaces.
- Ignorer requestId, timestamp, nonce, clés de cache ou IDs de tracking.
- Documenter les ajouts, suppressions et changements de type inattendus.
Points à inspecter
Cherchez les champs supprimés, clés renommées, changements d’ordre de tableaux et changements de type. Ce sont les plus risqués pour les clients.
Un passage de nombre à chaîne, de null à objet ou d’objet à tableau doit être traité comme un risque de compatibilité.
FAQ
Faut-il un diff texte ou JSON pour une réponse API ?
Si les deux entrées sont du JSON valide, utilisez JSON Diff. La structure est normalisée avant comparaison, ce qui rend les clés, tableaux et valeurs imbriquées plus lisibles.
Que faire si une réponse JSON est invalide ?
Passez-la d’abord dans JSON Validator et corrigez les erreurs de syntaxe. Sinon le diff montrera un échec de parsing plutôt qu’un changement de données.
Puis-je comparer des données API privées ?
Dans MKDiff, le JSON collé est traité dans le navigateur. Supprimez tout de même secrets, tokens et données personnelles avant de partager les résultats.