Převodník JSON na CSV

Co je tento nástroj?

API a databáze obvykle vracejí data jako JSON, ale tabulkové procesory, Excel, Google Sheets a většina nástrojů pro import dat očekávají CSV. Tento nástroj tuto mezeru překlenuje: vložte pole objektů JSON (třeba odpověď API) a nástroj vytvoří CSV s jedním sloupcem pro každý unikátní klíč a jedním řádkem pro každý objekt.

Převod zvládá detaily, na kterých naivní přístupy selhávají: hodnoty obsahující čárky nebo uvozovky se správně escapují, chybějící pole se stanou prázdnými buňkami místo toho, aby převod spadl, a vnořené objekty nebo pole uvnitř pole se serializují jako řetězec JSON v dané buňce místo toho, aby se tiše zahodily.

Výstup dodržuje pravidla uvozování z RFC 4180, de facto standardu CSV: jakékoli pole obsahující čárku, dvojitou uvozovku nebo zalomení řádku se obalí do dvojitých uvozovek a uvozovky uvnitř pole se zdvojí. Přesně to udrží hodnotu jako New York, NY v jednom sloupci místo tichého rozdělení na dva.

Proč ho používat?

• Automatická detekce záhlaví — seznam sloupců se sestaví ze sjednocení klíčů napříč všemi objekty, takže nekonzistentní záznamy výstup nerozbijí.
• Správné escapování CSV — hodnoty s čárkami, uvozovkami nebo zalomením řádku se správně uvozují, takže se soubor otevře v Excelu nebo Google Sheets bez problémů.
• Zvládá vnořená data — objekt nebo pole uvnitř pole se serializuje jako text JSON místo toho, aby způsobilo chybu.
• Kopírování do schránky nebo přímé stažení jako soubor .csv.
• 100% zpracování na straně klienta — vaše data (odpovědi API, exportované záznamy) se nikdy nikam nenahrávají.

Jak se používá

1. Vložte pole objektů JSON, např. [{"name":"Alice","age":30},{"name":"Bob","age":25}].
2. Klikněte na "Convert to CSV".
3. Zkontrolujte výstup — zkopírujte ho, nebo klikněte na "Download CSV" pro uložení souboru.
4. Otevřete stažený soubor v Excelu, Google Sheets nebo jakémkoli tabulkovém nástroji.

Příklad

Vstup

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

Výstup

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

Všimněte si, že se sloupci stanou jak „city“, tak „age“, přestože žádný jednotlivý objekt nemá obojí — chybějící hodnoty se prostě nechají prázdné.

Praktické tipy

• Převod odpovědi API pro tabulkovou zprávu: vložte pole JSON přímo ze záložky Network v prohlížeči nebo z nástroje pro testování API, převeďte a stáhněte — žádný mezikrok se skriptem není potřeba.
• Práce s nekonzistentními záznamy (např. volitelná pole z exportu formuláře): automatická detekce záhlaví znamená, že nemusíte nejdřív ručně sladit schémata.
• Pokud je váš JSON jeden velký objekt s vnořeným polem uvnitř (např. {"users": [...]}), extrahujte jen tu část s polem (část [...]), než ji sem vložíte.

Proč záleží na pořadí a úplnosti sloupců

Nenápadná, ale běžná chyba v CSV nastává, když se data exportují tak, že se nejdřív ručně napíšou záhlaví a doufá se, že jim bude odpovídat každý řádek: pokud má řádek 50 z 1000 navíc pole, které žádný z předchozích řádků neměl, naivní CSV writer psaný po řádcích buď toto pole tiše zahodí, nebo posune všechny následující sloupce mimo zarovnání. Tento nástroj se této chybě vyhýbá tím, že nejdřív projde každý objekt v poli a sestaví kompletní, správný řádek záhlaví ještě předtím, než napíše jediný řádek výstupu — takže pole, které se objeví jen jednou, u úplně posledního objektu, přesto dostane svůj vlastní sloupec a hodnota u všech ostatních řádků se pro něj správně zobrazí jako prázdná místo toho, aby narušila strukturu řádku.

Časté dotazy