Embellir un texte JSON

Un JSON minifié, sur une seule ligne ou indenté de façon irrégulière est difficile à lire dans les revues de code, les tickets de support et les dumps de journal. Cet outil d’embellissement de texte JSON accepte une chaîne JSON brute, la valide par une analyse stricte et re-sérialise la valeur avec une indentation d’espaces cohérente afin que les objets et tableaux imbriqués s’alignent de façon prévisible. Lorsque la charge utile est invalide, la tâche échoue avec invalid_input et signale la position de caractère de l’erreur d’analyse pour que vous puissiez aller directement à la virgule, guillemet ou fragment en trop incorrects. Pas de réordonnancement de clés au-delà de la sérialisation JSON standard, pas d’allers-retours réseau ni de jetons de modèle—seulement parse et stringify déterministes au prix de base publié $0.002 par appel réussi.

Ce que fait réellement l’embellissement d’une chaîne JSON

Embellir un texte JSON signifie prendre une chaîne qui prétend être du JSON, l’analyser en une valeur, puis réécrire cette valeur avec un nombre fixe d’espaces par niveau d’imbrication. Cette capacité prend votre champ text comme chaîne source, exécute un parse JSON strict et renvoie un nouveau champ text avec une indentation cohérente contrôlée par le paramètre optionnel indent (entier de zéro à huit, défaut deux espaces). L’algorithme ne récupère pas de schémas distants, ne répare pas le JSON cassé et ne réordonne pas les clés d’objet au-delà de l’ordre naturel de sérialisation du moteur sur l’objet analysé.

Contrat d’entrée, champs de réponse et positions d’erreur d’analyse

Envoyez éventuellement indent comme entier entre zéro et huit ; omettez-le pour utiliser deux espaces. Lorsque l’analyse échoue, le message d’erreur inclut toujours une position de caractère : les moteurs qui signalent « at position N » sont repris avec ce N, l’entrée incomplète est mappée à la fin de la chaîne et les autres échecs passent par défaut à la position zéro pour que le client ait toujours une cible de curseur. Associez ce point de terminaison à votre éditeur ou visionneuse de journaux en sautant au décalage signalé ; vous n’avez pas besoin d’un second appel de validation. Envoyez en POST un corps JSON avec une chaîne text obligatoire contenant le document à formater. Un text vide, non chaîne et un indent hors plage échouent avec invalid_input et ne sont pas facturés. En cas de succès la réponse inclut text (le document embelli), indent (l’espacement effectif utilisé), bytes_in (longueur UTF-8 de la chaîne source) et bytes_out (longueur UTF-8 du résultat formaté). Exemple : text égal à un objet minifié avec des tableaux imbriqués et indent égal à deux renvoie du JSON multiligne avec des pas de deux espaces et des accolades appariées. Exemple d’échec : un objet tronqué sans accolade fermante produit invalid_input mentionnant la position près de la fin du fragment.

Où l’embellissement de texte JSON apporte de la valeur

Les jobs CI peuvent rejeter ou réécrire des fichiers de configuration arrivés minifiés depuis des générateurs amont, en échouant vite avec une position d’analyse lorsqu’un artefact de livraison est tronqué en cours de téléversement. Une validation échouée ne consomme pas le solde. Gardez indent fixe dans un projet pour des diffs stables, stockez les goldens issus du gestionnaire plutôt que des espaces édités à la main, et vous obtenez un formatage reproductible pour revues, exercices LMS et workers en bordure sans monter une pile complète de transformation de données. Les développeurs collent des réponses API dans les chats et tickets ; embellir le texte JSON transforme des lignes opaques en arbres relisables sans installer un formateur de bureau. Les outils de support montrent aux clients le décalage exact d’un corps de webhook mal formé au lieu d’une bannière générique « JSON invalide ». Comme l’implémentation est parse de niveau A pur, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant. Préférez ce contrat texte en entrée et texte en sortie lorsque votre pipeline stocke déjà le JSON comme chaîne—journaux, contenus de fichiers, corps de messages—plutôt que comme objet pré-analysé.