JSON'dan CSV'ye Dönüştürücü

Nesnelerden oluşan bir JSON dizisini yapıştırın ve temiz, uygun şekilde kaçış karakterleri eklenmiş bir CSV dosyası elde edin — kopyalamaya veya indirmeye hazır. Sütun başlıkları, dizide yer alan her anahtardan otomatik olarak oluşturulur; böylece eksik veya fazladan alan içeren satırlar da doğru şekilde işlenir. Her şey tarayıcınızda çalışır; veriler cihazınızdan asla dışarı çıkmaz.

Bu Araç Nedir?

API’ler ve veritabanları genellikle verileri JSON formatında döndürür, ancak elektronik tablolar, Excel, Google Sheets ve çoğu veri içe aktarma aracı CSV formatını bekler. Bu araç bu boşluğu doldurur: Bir dizi JSON nesnesini (örneğin bir API yanıtı) yapıştırdığınızda, her benzersiz anahtar için bir sütun ve her nesne için bir satır içeren bir CSV dosyası oluşturur.

Bu dönüştürme işlemi, basit yaklaşımların başarısız olmasına neden olan ayrıntıları halleder: virgül veya tırnak işareti içeren değerler uygun şekilde kaçış karakterleriyle işlenir, eksik alanlar dönüştürme işlemini durdurmak yerine boş hücrelere dönüştürülür ve bir alanın içindeki iç içe geçmiş nesneler veya diziler, sessizce atılmak yerine o hücrede bir JSON dizesi olarak serileştirilir.

Neden Kullanmalısınız?

Otomatik başlık algılama — sütun listesi, tüm nesnelerdeki anahtarların birleşiminden oluşturulur; bu sayede tutarsız kayıtlar çıktıyı bozmaz.
Doğru CSV kaçış karakterleri — virgül, tırnak işareti veya satır sonu içeren değerler uygun şekilde tırnak içine alınır; böylece dosya Excel veya Google E-Tablolar’da sorunsuz bir şekilde açılır.
İç içe geçmiş verileri işler — bir alanın içindeki nesne veya dizi, hata vermeden JSON metnine dönüştürülür.
Panoya kopyalayın veya doğrudan .csv dosyası olarak indirin.
%100 istemci tarafında — verileriniz (API yanıtları, dışa aktarılan kayıtlar) hiçbir zaman hiçbir yere yüklenmez.

Nasıl Kullanılır

Nesnelerden oluşan bir JSON dizisini yapıştırın; örneğin: [{"name":"Alice","age":30},{"name":"Bob","age":25}].
"CSV'ye Dönüştür" seçeneğine tıklayın.
Çıktıyı inceleyin — kopyalayın veya "CSV'yi İndir" seçeneğine tıklayarak bir dosya kaydedin.
İndirdiğiniz dosyayı Excel, Google E-Tablolar veya herhangi bir elektronik tablo programında açın.

Örnek

Giriş

[{"name":"Alice","age":30},{"name":"Bob","city":"NYC"}]

Çıkış

name,age,city
Alice,30,
Bob,,NYC

Hiçbir nesnede her ikisi birden bulunmamasına rağmen, “şehir” ve “yaş”ın her ikisinin de sütun haline geldiğine dikkat edin — eksik değerler sadece boş bırakılır.

Pratik ipuçları

Bir hesap tablosu raporu için API yanıtını dönüştürme: JSON dizisini doğrudan tarayıcının “Ağ” sekmesinden veya bir API test aracından yapıştırın, dönüştürün ve indirin — ara komut dosyasına gerek yoktur.
Tutarsız kayıtlarla çalışma (örneğin, bir form dışa aktarımındaki isteğe bağlı alanlar): Otomatik başlık algılama özelliği sayesinde, şemaları önceden manuel olarak eşleştirmenize gerek kalmaz.
JSON'unuzun içinde iç içe geçmiş bir dizi içeren tek bir büyük nesne olması durumunda (örn. {"users": [...]}), buraya yapıştırmadan önce sadece dizi kısmını ( [...] kısmı) ayıklayın.

Sütun sırası ve eksiksizliğin önemi nedir?

Veriler, önce başlıkları elle yazıp her satırın uyumlu olmasını umarak dışa aktarıldığında, ince ama yaygın bir CSV hatası ortaya çıkar: 1000 satırlık bir dizide 50. satırda, önceki satırların hiçbirinde bulunmayan fazladan bir alan varsa, basit satır satır CSV yazma yöntemi bu alanı sessizce atlar ya da sonraki tüm sütunların hizasını bozar. Bu araç, tek bir çıktı satırı bile yazmadan önce dizideki her nesneyi tarayarak eksiksiz ve doğru başlık satırını oluşturarak bu hata durumunu önler — böylece, en son nesnede yalnızca bir kez görünen bir alan bile kendi sütununa sahip olur ve diğer tüm satırlardaki bu alana ait değerler, satır yapısını bozmak yerine doğru bir şekilde boş olarak gösterilir.

Sıkça Sorulan Sorular

Bu, dizi yerine tek bir JSON nesnesiyle de çalışıyor mu?

Bir dizi bekler — tek bir nesneyi köşeli parantez içine alın; örneğin, {"name":"Alice"} ifadesini [{"name":"Alice"}] olarak değiştirin; böylece tek satırlık bir CSV dosyasına dönüştürülecektir.

Bir alan içindeki iç içe geçmiş nesnelere veya dizilere ne olur?

Bu hücre içinde JSON dizesi olarak serileştirilirler (örneğin, {"a":1} içeren bir alan, CSV dosyasında "{""a"":1}" metnine dönüşür; tırnak işaretleri uygun şekilde kaçış karakterleriyle işlenir) ve hata vermez ya da atılmaz. İç içe geçmiş verilerin ayrı sütunlara düzleştirilmesi gerekiyorsa, bunun için şemaya özgü farklı bir araç kullanmanız gerekir.

Verilerim bir sunucuya yükleniyor mu?

Hayır. Dönüştürme işlemi tamamen tarayıcınızda JavaScript olarak çalışır — hiçbir bilgi dışarıya gönderilmez; bu da dışa aktarılan müşteri veya işletme verileriyle güvenli bir şekilde kullanılmasını sağlar.

CSV dosyamda neden boş hücreler var?

Dizinizdeki bazı nesnelerde, diğerlerinde bulunan bir anahtar eksikse, bu sütun mevcut olmakla birlikte, söz konusu anahtara sahip olmayan nesneler için hücre boş bırakılır — bu sayede, tutarsız kayıtlar nedeniyle hata verilmesi yerine tüm verileriniz korunur.

Virgülle ayrılmış değerler CSV dosyasını bozabilir mi?

Hayır. Virgül, tırnak işareti veya satır sonu içeren herhangi bir değer, standart CSV kuralları uyarınca otomatik olarak tırnak işaretleri içine alınır (iç tırnak işaretleri kaçış karakterleriyle işlenir); böylece Excel ve Google E-Tablolar’da doğru şekilde açılır.