Konwerter JSON na CSV

Czym jest to narzędzie?

Interfejsy API i bazy danych zazwyczaj zwracają dane w formacie JSON, ale arkusze kalkulacyjne, takie jak Excel, Arkusze Google oraz większość narzędzi do importowania danych wymagają formatu CSV. To narzędzie wypełnia tę lukę: wystarczy wkleić tablicę obiektów JSON (np. odpowiedź z interfejsu API), a narzędzie utworzy plik CSV z jedną kolumną na każdy unikalny klucz i jednym wierszem na każdy obiekt.

Konwersja zajmuje się szczegółami, które sprawiają kłopoty w prostych podejściach: wartości zawierające przecinki lub cudzysłowy są odpowiednio maskowane, brakujące pola zamieniane są na puste komórki, co nie powoduje awarii konwersji, a zagnieżdżone obiekty lub tablice wewnątrz pola są serializowane jako ciąg JSON w tej komórce, zamiast być po cichu pomijane.

Dlaczego warto go używać?

• Automatyczne wykrywanie nagłówków — lista kolumn jest tworzona na podstawie połączenia kluczy ze wszystkich obiektów, dzięki czemu niespójne rekordy nie zakłócają wyników.
• Prawidłowe kodowanie znaków w pliku CSV — wartości zawierające przecinki, cudzysłowy lub znaki końca linii są odpowiednio ujęte w cudzysłowy, dzięki czemu plik otwiera się bez problemów w programie Excel lub Arkusze Google.
• Obsługuje dane zagnieżdżone — obiekt lub tablica znajdująca się wewnątrz pola jest serializowana do formatu JSON zamiast powodować błąd.
• Skopiuj do schowka lub pobierz bezpośrednio jako plik .csv.
• W 100% po stronie klienta — Twoje dane (odpowiedzi API, wyeksportowane rekordy) nigdy nie są przesyłane nigdzie.

Jak używać

1. Wklej tablicę obiektów w formacie JSON, np. [{"name":"Alice","age":30},{"name":"Bob","age":25}].
2. Kliknij „Konwertuj do formatu CSV”.
3. Sprawdź wynik — skopiuj go lub kliknij „Pobierz CSV”, aby zapisać plik.
4. Otwórz pobrany plik w programie Excel, Arkuszach Google lub dowolnym innym arkuszu kalkulacyjnym.

Przykład

Wejście

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

Wynik

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

Zwróć uwagę, że zarówno „miasto”, jak i „wiek” stają się kolumnami, mimo że żaden obiekt nie zawiera obu tych danych — brakujące wartości są po prostu pozostawione puste.

Praktyczne wskazówki

• Konwersja odpowiedzi API do raportu w arkuszu kalkulacyjnym: wklej tablicę JSON bezpośrednio z zakładki „Sieć” przeglądarki lub narzędzia do testowania API, przekonwertuj i pobierz — bez potrzeby stosowania skryptu pośredniczącego.
• Praca z niespójnymi rekordami (np. polami opcjonalnymi z eksportu formularza): dzięki automatycznemu wykrywaniu nagłówków nie trzeba najpierw ręcznie dopasowywać schematów.
• Jeśli Twój plik JSON stanowi jeden duży obiekt zawierający zagnieżdżoną tablicę (np. {"users": [...]}), przed wklejeniem go tutaj wyodrębnij tylko część zawierającą tablicę (czyli fragment [...]).

Dlaczego kolejność kolumn i kompletność mają znaczenie

Subtelny, ale powszechny błąd związany z plikami CSV pojawia się, gdy dane są eksportowane poprzez ręczne wpisanie nagłówków i liczenie na to, że każdy wiersz będzie pasował: jeśli wiersz 50 z 1000 zawiera dodatkowe pole, którego nie ma w żadnym z wcześniejszych wierszy, proste narzędzie do zapisywania plików CSV wiersz po wierszu albo pomija to pole bez ostrzeżenia, albo powoduje przesunięcie wszystkich kolejnych kolumn, co zaburza ich wyrównanie. Narzędzie to pozwala uniknąć tego rodzaju błędu, najpierw skanując każdy obiekt w tablicy w celu utworzenia kompletnego, poprawnego wiersza nagłówkowego przed zapisaniem choćby jednej linii danych wyjściowych — dzięki temu pole, które pojawia się tylko raz, w ostatnim obiekcie, nadal otrzymuje własną kolumnę, a wartości w nim zawarte w pozostałych wierszach są poprawnie wyświetlane jako puste, zamiast zakłócać strukturę wiersza.

Najczęściej zadawane pytania