Come formattare JSON online: abbellire, convalidare e correggere errori

Copi una risposta JSON da un’API, la incolli nel tuo editor e ti ritrovi con un’unica lunga riga di testo ininterrotta, senza alcuna spaziatura. Da qualche parte in quel muro di caratteri si nasconde il valore che ti serve, ma leggerlo a occhio e quasi impossibile. Formattare il JSON risolve esattamente questo. Questa guida spiega cosa fanno davvero l’abbellimento e la convalida del JSON, e come il Formattatore JSON gratuito trasforma dati disordinati in qualcosa che puoi leggere.

Cosa significano formattare e convalidare

Sono due compiti distinti che i buoni strumenti gestiscono insieme.

Formattare (chiamato anche abbellire o stampare in modo leggibile) aggiunge interruzioni di riga e indentazione affinche la struttura dei dati diventi visibile. Gli oggetti annidati rientrano verso l’interno, gli array si allineano e ogni chiave occupa la propria riga. I dati non cambiano affatto, cambia solo la loro presentazione.

Convalidare verifica innanzitutto se il testo e JSON valido. Il JSON ha regole rigorose: le chiavi devono stare tra virgolette doppie, le stringhe non possono usare virgolette singole e non esistono commenti. Un validatore ti dice se il documento viene analizzato correttamente e, in caso contrario, ti indica il punto in cui si e rotto.

Di solito vuoi entrambe le cose. Formattare per leggerlo, convalidare per fidarti.

Perche il JSON minificato e illeggibile

Il JSON scambiato tra server e quasi sempre minificato, ovvero ogni spazio e ogni a capo facoltativo sono stati rimossi. Questo va bene per le macchine: payload piu piccoli viaggiano piu velocemente e consumano meno banda. E pessimo per le persone.

Un oggetto minificato appare cosi: {"user":{"id":42,"roles":["admin","editor"],"active":true}}. Questo e gestibile. Ma una vera risposta di un’API puo estendersi per migliaia di caratteri su una sola riga, con oggetti annidati fino a cinque livelli di profondita. Senza indentazione non puoi capire dove finisce un oggetto e inizia il successivo, e abbinare una parentesi graffa di chiusura alla sua apertura diventa un indovinello. La formattazione ripristina la gerarchia visiva affinche la forma dei dati corrisponda alla forma sullo schermo.

Individuare gli errori di sintassi comuni

La maggior parte dei problemi del JSON deriva da una manciata di piccoli errori. Un validatore li individua all’istante invece di lasciarli fallire in silenzio piu a valle. Fai attenzione a questi:

• Virgole finali. Una virgola dopo l’ultimo elemento di un oggetto o di un array, come {"a":1,}, e valida in JavaScript ma vietata in JSON.
• Virgolette singole. Il JSON richiede virgolette doppie. {'name':'Sam'} non verra analizzato.
• Virgolette mancanti sulle chiavi. Ogni chiave deve essere tra virgolette: {name:"Sam"} non e valido.
• Caratteri non preceduti da escape. Un a capo grezzo o una virgoletta senza escape all’interno di una stringa rompe l’analisi.
• Parentesi non corrispondenti. Un solo } o ] mancante manda fuori strada l’intero documento.

Quando il Formattatore JSON segnala un errore, leggi la posizione che ti fornisce e guarda subito prima di quel punto. L’errore vero spesso si trova un carattere prima del punto in cui l’analizzatore ha infine rinunciato.

Leggere le risposte delle API con sicurezza

Quando esegui il debug di un’integrazione, la formattazione e il modo piu rapido per capire cosa ha effettivamente restituito un endpoint. Incolla la risposta grezza, abbelliscila e potrai vedere immediatamente quali campi esistono, se una lista e tornata vuota e quanto e profondo l’annidamento. Questo trasforma un vago “i dati sembrano sbagliati” in un preciso “all’array items manca il campo price”.

Poiche il Formattatore JSON e gratuito, non richiede registrazione e funziona interamente nel tuo browser, la risposta che incolli non lascia mai il tuo dispositivo. Questo conta quando un payload contiene token, indirizzi e-mail o qualsiasi altra cosa che non vorresti caricare su un server qualunque solo per leggerla.

Lavorare con formati correlati

Il JSON vive raramente da solo, e la conversione tra formati e un passo successivo comune. Se hai dati in un’esportazione da foglio di calcolo e ti servono come JSON strutturato, il convertitore da CSV a JSON trasforma righe e colonne in oggetti che puoi inserire direttamente nel codice. Se stai estraendo dati da un sistema datato o da un servizio SOAP, il convertitore da XML a JSON rimodella i tag in coppie chiave-valore pulite. E quando un campo JSON contiene un blocco codificato, lo strumento di codifica e decodifica Base64 lo decodifica cosi puoi vedere cosa c’e davvero dentro.

La versione breve

La formattazione rende il JSON leggibile ripristinando l’indentazione, e la convalida conferma che il documento e davvero valido prima che tu vi faccia affidamento. Insieme trasformano una stringa minificata e soggetta a errori in qualcosa di cui puoi fidarti e su cui puoi ragionare. La prossima volta che un’API ti consegna una riga di testo illeggibile, incollala nel Formattatore JSON, lascia che la abbellisca e ne controlli la struttura, e leggi i tuoi dati come dovevano essere letti.