POST /v1/csv2json {"csv":"name,ort\n…"}
{ "zeilen": [{"name": "Müller, Anna", "ort": "Köln"}, {"name": "Schmidt", "ort": "Berlin"}] }
Der Export aus der Warenwirtschaft sieht in Excel harmlos aus, bis jemand genauer hinschaut: Aus der Postleitzahl 08154 ist 8154 geworden, die Artikelnummer steht als 4,5E+11 da, und die Kundin heißt jetzt „M?ller“. Spielst du die Datei zurück, hast du den Schaden in der Datenbank; korrigierst du sie von Hand, sitzt du einen Tag daran.
Die erste Zeile ist die Kopfzeile, jede weitere wird ein Objekt. Interessant sind nicht die Normalfälle, sondern die Ränder:
| CSV-Zeile | Ergebnis | Regel |
|---|---|---|
Meier,Köln | {"name":"Meier","ort":"Köln"} | Normalfall |
"Müller, Anna",Köln | {"name":"Müller, Anna", …} | Komma im Feld überlebt |
"Er sagte ""ja""",Köln | {"name":"Er sagte \"ja\"", …} | doppelte Anführungszeichen werden zu einem |
Meier (zweite Spalte fehlt) | {"name":"Meier","ort":""} | fehlende Felder werden leer, nicht null |
Meier,Köln,X | {"name":"Meier","ort":"Köln"} | überzählige Felder fallen weg |
Meier, Köln | {"name":"Meier","ort":"Köln"} | Leerzeichen am Feldrand werden entfernt |
08154,Köln | {"plz":"08154", …} | alle Werte bleiben Text — führende Nullen überleben |
In die andere Richtung entsteht die Kopfzeile aus allen Schlüsseln, die in irgendeinem Objekt vorkommen, in der Reihenfolge ihres ersten Auftretens. Fehlt ein Schlüssel in einem einzelnen Objekt, bleibt dessen Zelle leer, statt die restliche Zeile zu verschieben. Felder mit Trennzeichen, Anführungszeichen oder Zeilenumbruch werden automatisch gequotet und innenliegende Anführungszeichen verdoppelt. Auch die Spaltennamen werden beim Einlesen getrimmt: aus name; ort werden die Schlüssel name und ort, nicht name und ort.
Die meisten kaputten Importe sind schon kaputt, bevor eine einzige Zeile Code läuft:
3-11 wird der 3. November, aus 1/2 der 1. Februar. Zurückverwandeln lässt sich das nicht.12,50 die Zeile in zwei Felder — und verschiebt alle folgenden Spalten.name, sondern etwas, das im Protokoll genauso aussieht — und jeder Feldzugriff darauf läuft ins Leere.Zwei Grenzen des Konverters selbst: Ein Zeilenumbruch innerhalb eines Feldes — typisch bei mehrzeiligen Bemerkungsfeldern — wird als neue Zeile gelesen. Solche Umbrüche musst du vor dem Aufruf ersetzen. Und je Aufruf werden bis zu 5 MB CSV verarbeitet; darüber antwortet die API mit too_long, und du zerlegst den Bestand in Blöcke.
Ja — geparst und erzeugt wird nach RFC 4180, dem CSV-Standard. "Müller, Anna" bleibt ein Feld, Anführungszeichen werden korrekt maskiert, in beide Richtungen. Genau daran scheitern selbstgebaute Split-Lösungen.
Ja. Deutsches Excel exportiert mit Semikolon statt Komma — das Trennzeichen ist wählbar, sowohl beim Einlesen als auch beim Erzeugen.
Alles läuft in UTF-8, Umlaute und Sonderzeichen kommen unverändert durch. Falls deine Quelldatei aus altem Windows-Excel kommt, konvertiere sie einmal nach UTF-8 — danach ist der Weg rund.
Einige Megabyte pro Aufruf — das deckt typische Exporte mit zehntausenden Zeilen ab. Größere Bestände teilst du in Blöcke; das Ergebnis lässt sich verlustfrei aneinanderhängen.
Ja — die Reihenfolge der CSV-Spalten und der JSON-Schlüssel bleibt stabil, in beide Richtungen. Das ist wichtig für Systeme, die Spalten über die Position statt über den Namen zuordnen.
Aktuell ist alles in der Beta komplett kostenlos — keine Kreditkarte, keine Laufzeit. Nach dem Verkaufsstart beginnen die Tarife bei 4,50 € pro Monat (50.000 Aufrufe) — bewusst rund die Hälfte des üblichen Marktpreises. Wer in der Beta dabei ist, wird vor jeder Umstellung informiert.
E-Mail-Adresse in das Formular auf dieser Seite eintragen — der API-Schlüssel erscheint sofort, ohne Bestätigungs-Wartezeit. Damit hast du 1.000 Aufrufe pro Monat frei. Der Schlüssel wird als Hash gespeichert und nur einmal angezeigt, also direkt sicher ablegen.
E-Mail eintragen, Schlüssel erscheint sofort auf der Seite. Kein Konto, keine Kreditkarte, keine Freischaltung durch uns.
Ein einziger HTTP-Aufruf mit deinem Schlüssel im Kopf — aus jeder Programmiersprache, jedem Framework, jedem Automatisierungswerkzeug.
Du bekommst sauberes JSON oder die fertige Datei zurück. Fehler kommen als klare deutsche Meldung, nicht als Rätsel.
POST /v1/csv2json {"csv":"name,ort\n…"}
Wir legen die Preise jetzt schon offen, damit du planen kannst. Beta-Nutzer werden rechtzeitig informiert, bevor sich etwas ändert — niemand wird automatisch in einen bezahlten Tarif überführt.
Alle Preise zuzüglich Umsatzsteuer. Monatlich kündbar, keine Mindestlaufzeit, keine Einrichtungsgebühr.
Verwandt: Feiertags-API · MwSt-Rechner · Markdown → HTML · Textlesbarkeit