Formater et vérifier du JSON sur Mac : d’une réponse d’API à des données lisibles

Pour examiner une réponse JSON compacte sur Mac, collez le JSON seul dans l’outil JSON de Frset et choisissez le formatage. La minification permet d’obtenir de nouveau une version compacte. Ces deux opérations vérifient la syntaxe JSON ; aucune ne confirme que les données contiennent les champs ou les valeurs adaptés à votre API.

Copiez le corps de la réponse sans le journal qui l’entoure

Un client d’API peut afficher ensemble du texte de statut, des en-têtes et un corps de réponse. Un formateur a besoin de la partie JSON. Une ligne telle que « Réponse reçue : » avant un objet, ou un bloc de code copié depuis un message, peut empêcher l’analyse d’un JSON par ailleurs valide.

Conservez la réponse originale avant toute modification. Par exemple, {"project":"demo","enabled":true,"items":[1,2]} est un petit objet valide qui permet de vérifier le workflow. Le formatage rend sa structure plus lisible sans changer les valeurs qu’il est censé contenir.

Formatez ou minifiez avec Frset

1. Ouvrez la recherche Frset et sélectionnez JSON, avec le mot-clé /json par défaut s’il n’a pas été modifié.
2. Collez le corps JSON dans le champ de l’outil.
3. Choisissez Format pour ajouter une indentation lisible ou Minify pour retirer les espaces inutiles.
4. Lancez l’outil et examinez le résultat.
5. Collez le résultat copié dans votre éditeur, votre client d’API ou votre note de travail.

Les résultats obtenus sont ajoutés à l’historique Frset et copiés dans le presse-papiers système. Vous pouvez les retrouver avec le gestionnaire de presse-papiers, selon les règles d’accès et de conservation de votre offre. Les limites d’utilisation de l’outil dépendent aussi de l’offre.

Le formatage JSON est une opération locale ; il ne nécessite ni fournisseur d’IA ni site de formatage en ligne. L’outil conserve l’ordre des clés, les valeurs numériques littérales et le contenu des chaînes, tout en modifiant la présentation. La minification supprime les espaces de mise en forme, pas ceux qui se trouvent dans les valeurs textuelles ; ce n’est ni une compression de fichier ni un chiffrement.

Examinez une erreur de syntaxe

En cas d’échec de l’analyse, vérifiez le texte copié au lieu de supposer que l’outil doit le réparer. Parmi les problèmes courants :

• Des virgules manquantes ou des accolades et crochets non équilibrés.
• Des apostrophes autour de clés ou de chaînes alors que JSON exige des guillemets doubles.
• Une virgule après le dernier élément d’un objet ou d’un tableau.
• Des commentaires, un préfixe de journal ou une page d’erreur HTML mêlés à l’entrée.
• Des guillemets ou des sauts de ligne non échappés dans une chaîne.

La spécification JSON, RFC 8259, définit le format. Un objet littéral JavaScript ou un format de configuration qui autorise les commentaires n’est pas nécessairement du JSON valide. Corrigez la source de façon délibérée et réessayez ; le formateur ne détermine pas quelle valeur manquante était attendue.

Distinguez des données lisibles de données valides

Un formatage réussi signifie que l’entrée a pu être analysée. Il ne confirme pas qu’un identifiant existe, qu’un horodatage utilise la bonne unité ou qu’un champ respecte le contrat de l’API de réception. Validez les données par rapport au schéma de votre application et à ses règles métier avec les outils de développement adaptés.

Vérifiez aussi si une valeur est une chaîne ou un nombre. Remplacer "0012" par 12 modifie la donnée, même si le résultat est toujours analysable. Si un champ de date contient un entier qui vous est inconnu, consultez séparément le guide de conversion des horodatages pour vérifier l’unité et le fuseau horaire.

Pour les tâches récurrentes, donnez un nom aux copies importantes ou gardez un exemple maintenu dans une note. Voir comment enregistrer des extraits de code et des commandes. Une réponse lisible constitue un meilleur point de départ pour le débogage, mais la requête d’origine et le comportement de l’API restent déterminants.