Convertitore da JSON a CSV online

Il JSON è il formato con cui le API e le applicazioni web scambiano dati: usa chiavi e valori organizzati in una struttura ad albero, leggibile dal codice ma poco pratica per chi lavora con i fogli di calcolo. Il CSV, invece, è una semplice tabella in cui ogni riga rappresenta un record e le colonne sono separate da virgole.

Convertire da JSON a CSV serve quando vuoi aprire i dati in Excel o Google Fogli, importarli in un database o condividerli con colleghi che non leggono il codice. La differenza strutturale principale è che il JSON è gerarchico e può contenere oggetti dentro altri oggetti, mentre il CSV è piatto e bidimensionale.

Il nostro convertitore colma questo divario: legge un array di oggetti, individua le chiavi comuni e le trasforma in intestazioni di colonna. Ogni oggetto diventa una riga della tabella. Se hai bisogno del percorso inverso, puoi usare il convertitore da CSV a JSON in qualsiasi momento.

Il processo si svolge in tre fasi. Prima lo strumento analizza il testo JSON che incolli e verifica che sia valido, segnalando eventuali errori di sintassi come parentesi o virgole mancanti. Se vuoi controllare la struttura prima della conversione, il formattatore JSON aiuta a renderla leggibile.

Nella seconda fase il convertitore raccoglie tutte le chiavi presenti negli oggetti dell'array e le usa come intestazioni della tabella. Ogni oggetto viene poi mappato su una riga, abbinando i valori alle colonne corrispondenti. Quando una chiave manca in un oggetto, la cella resta vuota per mantenere l'allineamento.

La terza fase gestisce i casi particolari. Gli oggetti annidati vengono appiattiti con la notazione a punti, ad esempio indirizzo.citta. I valori che contengono virgole, virgolette o ritorni a capo vengono racchiusi tra virgolette ed eseguito l'escape secondo lo standard CSV. Il risultato è un file pulito e pronto da scaricare o copiare.

Il JSON reale raramente è piatto. Spesso un oggetto contiene altri oggetti o liste di valori, e il CSV non prevede nativamente questa profondità. Lo strumento risolve il problema appiattendo la gerarchia.

Considera questo esempio di oggetto:

`` { "nome": "Anna", "indirizzo": { "citta": "Milano", "cap": "20100" } } ``

Viene convertito in colonne distinte:

La chiave annidata indirizzo diventa il prefisso delle sue sottochiavi, separato da un punto. Gli array all'interno di un valore vengono serializzati in una singola cella, così non perdi informazioni anche quando un campo contiene più elementi.

Questo approccio mantiene ogni dato in una posizione prevedibile e riproducibile. Se in seguito ti serve un formato a marcatori gerarchici anziché tabellare, puoi passare al convertitore da JSON a XML partendo dagli stessi dati.

La conversione da JSON a CSV risolve problemi concreti in molti contesti. Il più comune è l'esportazione delle risposte di un'API verso un foglio di calcolo: ottieni i dati in JSON da un endpoint e li trasformi in una tabella che chiunque può aprire in Excel o Google Fogli.

Un secondo scenario è la creazione di report. Quando un servizio restituisce migliaia di record, il CSV permette di filtrare, ordinare e creare grafici senza scrivere codice. Anche i colleghi del reparto vendite o marketing possono lavorare sui dati in autonomia.

La migrazione tra sistemi è un altro caso frequente. Molti gestionali e database accettano l'importazione in CSV ma non in JSON, quindi la conversione diventa il ponte necessario per spostare i dati.

Infine c'è l'archiviazione e la condivisione: un file CSV occupa poco spazio, si apre ovunque e non richiede strumenti specializzati. Per riportare i dati in formato strutturato basta usare il convertitore da CSV a JSON.

Una domanda ricorrente riguarda la fedeltà della conversione. In linea generale il passaggio da JSON a CSV conserva tutti i valori, ma comporta un appiattimento della struttura: la gerarchia ad albero del JSON viene tradotta in colonne piatte con la notazione a punti.

Questo significa che i dati restano completi, ma l'informazione su quale chiave fosse annidata in quale oggetto è codificata nei nomi delle colonne anziché nella forma del documento. Se riconverti il CSV in JSON, dovrai interpretare di nuovo i prefissi a punti per ricostruire gli oggetti originali.

Alcuni dettagli meritano attenzione. I tipi di dato non vengono preservati in modo esplicito perché il CSV tratta tutto come testo: il numero 42 e la stringa "42" appaiono identici. I valori null diventano celle vuote. Per questo motivo conviene verificare il risultato dopo la conversione, soprattutto quando lavori con date, valori booleani o numeri che potrebbero essere reinterpretati dal foglio di calcolo.