Formattare testo JSON

Il JSON minificato, su una sola riga o con indentazione incoerente è difficile da leggere nelle revisioni di codice, nei ticket di supporto e nei dump di log. Questo strumento di formattazione del testo JSON accetta una stringa JSON grezza, la valida con un’analisi rigorosa e ri-serializza il valore con indentazione a spazi coerente affinché oggetti e array annidati si allineino in modo prevedibile. Quando il payload non è valido, l’attività fallisce con invalid_input e riporta la posizione di carattere dell’errore di analisi così Lei può andare subito alla virgola, alle virgolette o al frammento in eccesso errati. Nessun riordino di chiavi oltre la serializzazione JSON standard, nessun viaggio di rete e nessun token di modello—solo parse e stringify deterministici al prezzo base pubblicato $0.002 per chiamata riuscita.

Cosa fa davvero la formattazione di una stringa JSON

Formattare testo JSON significa prendere una stringa che afferma di essere JSON, analizzarla in un valore e riscrivere quel valore con un numero fisso di spazi per livello di annidamento. Questa capacità prende il campo text come stringa sorgente, esegue un parse JSON rigoroso e restituisce un nuovo campo text con indentazione coerente controllata dal parametro opzionale indent (intero da zero a otto, predefinito due spazi). L’algoritmo non recupera schemi remoti, non ripara JSON rotto e non riordina le chiavi dell’oggetto oltre l’ordine naturale di serializzazione del motore sull’oggetto analizzato.

Contratto di input, campi di risposta e posizioni di errore di analisi

Facoltativamente invii indent come intero tra zero e otto; lo ometta per usare due spazi. Quando l’analisi fallisce, il messaggio di errore include sempre una posizione di carattere: i motori che segnalano “at position N” sono riecheggiati con quel N, l’input incompleto è mappato alla fine della stringa e gli altri fallimenti vanno per impostazione predefinita alla posizione zero affinché il client abbia sempre una destinazione del cursore. Invii in POST un corpo JSON con una stringa text obbligatoria contenente il documento da formattare. Text vuoto, non stringa e indent fuori intervallo falliscono con invalid_input e non vengono fatturati. In caso di successo la risposta include text (il documento formattato), indent (la spaziatura effettiva usata), bytes_in (lunghezza UTF-8 della stringa sorgente) e bytes_out (lunghezza UTF-8 del risultato formattato). Esempio: text uguale a un oggetto minificato con array annidati e indent uguale a due restituisce JSON multilinea con passi di due spazi e graffe abbinate. Esempio di fallimento: un oggetto troncato senza graffa di chiusura produce invalid_input citando la posizione vicino alla fine del frammento. Abbini questo endpoint all’editor o al visualizzatore di log saltando all’offset segnalato; non serve una seconda chiamata di validazione.

Dove la formattazione del testo JSON crea valore

I job CI possono rifiutare o riscrivere file di configurazione che arrivano minificati da generatori a monte, fallendo in fretta con una posizione di analisi quando un artefatto di rilascio viene troncato a metà caricamento. La validazione fallita non consuma il saldo. Gli sviluppatori incollano risposte API in chat e ticket; formattare testo JSON trasforma righe opache in alberi revisionabili senza installare un formattatore desktop. Gli strumenti di supporto mostrano ai clienti l’offset esatto di un corpo webhook malformato invece di un banner generico di “JSON non valido”. Poiché l’implementazione è parse di livello A puro, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello e senza rete in uscita. Preferisca questo contratto testo in ingresso e testo in uscita quando la pipeline già conserva JSON come stringa—log, contenuti di file, corpi di messaggio—piuttosto che come oggetto pre-analizzato.