Von CSV zu JSON: Arbeiten mit tabellarischen Daten in APIs

CSV ist das Format, über das die Geschäftswelt noch immer Daten austauscht: Exporte aus CRMs, Kontoauszüge und Inventarberichte. JSON ist das, was die meisten REST- und Serverless-APIs erwarten. Ein sauberer Wechsel zwischen beiden spart stundenlange Ad-hoc-Skripte.

Die übliche Struktur: Array von Objekten

Für APIs ist das praktischste JSON-Format ein Array von Objekten – ein Objekt pro Zeile, mit den Schlüsseln aus der Kopfzeile:

[
  { "sku": "A-100", "qty": "12", "warehouse": "East" },
  { "sku": "B-220", "qty": "3", "warehouse": "West" }
]

Beachte, dass CSV Zeichenketten überträgt, sofern kein separater Typisierungsschritt hinzugefügt wird. Deine API sollte qty bei Bedarf in eine Zahl umwandeln.

Header und Konsistenz

• Die erste Zeile muss Spaltennamen enthalten; benenne Duplikate vor der Konvertierung um.
• Achte auf BOM-Zeichen am Anfang von UTF-8-Exporten aus Excel – sie können einen einfachen Parser stören und deinen ersten Header in \uFEFFsku verwandeln.
• Felder in Anführungszeichen können Kommas und Zeilenumbrüche enthalten; gute Parser verarbeiten sie korrekt; ein einfaches Aufteilen per Regex nach Komma hingegen nicht.

Wenn JSON → CSV

Berichtstools und E-Mail-Anhänge benötigen oft wieder CSV. Exportiere eine Zeile pro Objekt; verwende die Vereinigung aller Schlüssel als Spalten, wenn sich Objekte unterscheiden (fehlende Werte ergeben leere Zellen).

Vor der Produktion validieren

Führe dein JSON nach der Konvertierung durch einen JSON Formatter, um abschließende Kommas, einfache Anführungszeichen oder versehentliche NaN-Werte aus Tabellenkalkulationsformeln zu erkennen.

Wenn deine Pipeline auch YAML aus Konfigurations-Repositories akzeptiert, kann YAML to JSON dabei helfen, alles auf dieselben JSON-Schema-Tests auszurichten.

Lokal ausprobieren

Unser CSV ↔ JSON Converter läuft im Browser: Füge einen Beispielexport ein, erhalte formatierten JSON-Output, oder konvertiere in die andere Richtung für einen schnellen Bericht. Es werden keine Dateien übertragen.

Behandle CSV als nicht vertrauenswürdige Eingabe, wenn Benutzer es hochladen – begrenze die Dateigröße, prüfe auf Formel-Injection in Excel (=cmd|), und führe Zellinhalte niemals als Code aus.

Zusammenfassung

• Bevorzuge Header + Zeilen → Array von Objekten für APIs.
• Halte die Regeln für Anführungszeichen ein; verzichte auf selbst geschriebene CSV-Parser für den Produktionseinsatz.
• Validiere JSON und Schema immer, bevor du Daten an nachgelagerte Dienste sendest.