Konvertor JSON na CSV

Čo je tento nástroj?

API a databázy zvyčajne vracajú dáta ako JSON, ale tabuľkové procesory, Excel, Google Sheets a väčšina nástrojov na import dát očakávajú CSV. Tento nástroj preklenuje túto medzeru: vložte pole JSON objektov (napríklad odpoveď API) a vytvorí CSV s jedným stĺpcom na jedinečný kľúč a jedným riadkom na objekt.

Konverzia zvláda detaily, ktoré kazia naivné prístupy: hodnoty obsahujúce čiarky alebo úvodzovky sú správne escapované, chýbajúce polia sa stanú prázdnymi bunkami namiesto zrútenia konverzie, a vnorené objekty alebo polia vo vnútri poľa sú serializované ako JSON reťazec v tej bunke namiesto toho, aby boli ticho zahodené.

Výstup dodržiava pravidlá úvodzoviek podľa RFC 4180, de-facto štandardu CSV: akékoľvek pole obsahujúce čiarku, dvojitú úvodzovku alebo zalomenie riadku je obalené dvojitými úvodzovkami, a úvodzovky vo vnútri poľa sú zdvojené. Presne to udržuje hodnotu ako New York, NY v jednom stĺpci namiesto tichého rozdelenia na dva.

Prečo ho používať?

• Automatická detekcia hlavičky — zoznam stĺpcov sa vytvára zo zjednotenia kľúčov naprieč všetkými objektmi, takže nekonzistentné záznamy nepokazia výstup.
• Správne escapovanie CSV — hodnoty s čiarkami, úvodzovkami alebo zalomeniami riadkov sú správne v úvodzovkách, takže sa súbor bez problémov otvorí v Exceli alebo Google Sheets.
• Zvláda vnorené dáta — objekt alebo pole vo vnútri poľa je serializovaný na JSON text namiesto vyvolania chyby.
• Skopírovanie do schránky alebo priame stiahnutie ako .csv súbor.
• 100% na strane klienta — vaše dáta (odpovede API, exportované záznamy) sa nikam nenahrávajú.

Ako sa používa

1. Vložte JSON pole objektov, napr. [{"name":"Alice","age":30},{"name":"Bob","age":25}].
2. Kliknite na "Convert to CSV".
3. Skontrolujte výstup — skopírujte ho alebo kliknite na "Download CSV" pre uloženie súboru.
4. Otvorte stiahnutý súbor v Exceli, Google Sheets, alebo akomkoľvek tabuľkovom nástroji.

Príklad

Vstup

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

Výstup

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

Všimnite si, ako sa "city" aj "age" stanú stĺpcami, aj keď žiadny jednotlivý objekt nemá oboje — chýbajúce hodnoty sa jednoducho nechajú prázdne.

Praktické tipy

• Konverzia odpovede API pre tabuľkovú správu: vložte JSON pole priamo z karty Network prehliadača alebo nástroja na testovanie API, prekonvertujte a stiahnite — bez potreby medzikroku so skriptom.
• Práca s nekonzistentnými záznamami (napr. voliteľné polia z exportu formulára): automatická detekcia hlavičky znamená, že nemusíte najprv ručne zosúlaďovať schémy.
• Ak je váš JSON jeden veľký objekt s vnoreným poľom (napr. {"users": [...]}), pred vložením sem extrahujte len časť poľa (časť [...]).

Prečo záleží na poradí a úplnosti stĺpcov

Subtílna, ale bežná chyba CSV nastáva, keď sa dáta exportujú ručným písaním hlavičiek najprv a dúfaním, že každý riadok zodpovedá: ak riadok 50 z 1000 má prebytočné pole, ktoré nemal žiadny predchádzajúci riadok, naivný riadkový CSV zapisovač buď toto pole ticho zahodí, alebo posunie každý nasledujúci stĺpec mimo zarovnania. Tento nástroj sa tejto chybe vyhýba tak, že najprv preskenuje každý objekt v poli, aby vytvoril kompletný, správny riadok hlavičky pred zápisom jedného riadku výstupu — takže pole, ktoré sa objaví len raz, na úplne poslednom objekte, stále dostane vlastný stĺpec a hodnota pre neho v každom inom riadku sa správne zobrazí ako prázdna namiesto poškodenia štruktúry riadku.

Časté otázky