--- seo_title: Datenformat-Konvertierungs-API für JSON, XML, YAML, CSV | EnConvert meta_desc: Konvertiere JSON, XML, YAML, CSV, TOML und Markdown mit EnConverts REST-API für Datenformate. Elf POST-Endpunkte liefern Ergebnisse direkt oder über presigned URLs. keywords: datenformat konvertierung api, json xml yaml csv konverter api, json in xml umwandeln api, csv in json konvertieren api, yaml in json umwandeln api, json in toml konvertieren api, markdown in html umwandeln api, strukturierte daten konvertieren api --- # API für Datenformat-Konvertierung Die Datenformat-Endpunkte konvertieren strukturierte Datendateien zwischen JSON, XML, YAML, CSV und TOML und rendern zudem Markdown zu vollständig gestyltem HTML. Jede Konvertierung ist eine einzelne `POST`-Anfrage mit einem `multipart/form-data`-Datei-Upload: Sende deine Datei, erhalte das konvertierte Ergebnis als rohe Bytes zurück, oder fordere stattdessen eine presigned Download-URL an. Alle elf Endpunkte folgen derselben Request-Struktur, Authentifizierung und demselben Fehlermodell, sodass die Integration eines zweiten Formats nach dem ersten nur Minuten dauert. ## Unterstützte Konvertierungen | Konvertierung | Endpunkt | Beschreibung | |------------|----------|-------------| | [JSON zu XML](/de/docs/endpoints/convert/data-formats/json-to-xml.md) | `POST /v1/convert/json-to-xml` | Konvertiert JSON zu XML, wobei Objekte zu Kindelementen von `` werden, Arrays in ``-Elemente verpackt werden und Skalare in `` stehen. | | [XML zu JSON](/de/docs/endpoints/convert/data-formats/xml-to-json.md) | `POST /v1/convert/xml-to-json` | Konvertiert XML zu JSON, wobei Attribute auf `@`-präfixierte Keys, Textinhalte auf `#text` und wiederholte Sibling-Elemente auf Arrays abgebildet werden. | | [JSON zu YAML](/de/docs/endpoints/convert/data-formats/json-to-yaml.md) | `POST /v1/convert/json-to-yaml` | Direkte Abbildung in menschenlesbares YAML im Block-Stil, wobei Key-Reihenfolge und Unicode erhalten bleiben. | | [YAML zu JSON](/de/docs/endpoints/convert/data-formats/yaml-to-json.md) | `POST /v1/convert/yaml-to-json` | Parst `.yaml`- oder `.yml`-Dateien sicher (keine beliebige Codeausführung) zu pretty-printed JSON mit 2-Leerzeichen-Einrückung. | | [JSON zu CSV](/de/docs/endpoints/convert/data-formats/json-to-csv.md) | `POST /v1/convert/json-to-csv` | Konvertiert ein JSON-Array von Objekten zu kommagetrenntem CSV, wobei die Headers aus den Keys des ersten Objekts übernommen werden. | | [CSV zu JSON](/de/docs/endpoints/convert/data-formats/csv-to-json.md) | `POST /v1/convert/csv-to-json` | Konvertiert CSV zu einem JSON-Array, wobei die Header-Zeile zu den Keys wird und jeder Wert ein String bleibt (keine Typinferenz). | | [JSON zu TOML](/de/docs/endpoints/convert/data-formats/json-to-toml.md) | `POST /v1/convert/json-to-toml` | Konvertiert JSON zu TOML, wobei Arrays unter einem `items`-Key und Skalare unter `value` verpackt werden; `null`-Werte werden mit einem 400 abgelehnt. | | [TOML zu JSON](/de/docs/endpoints/convert/data-formats/toml-to-json.md) | `POST /v1/convert/toml-to-json` | Konvertiert TOML-Tabellen und -Arrays zu pretty-printed JSON und serialisiert Datetime-Werte als ISO-8601-Strings. | | [CSV zu XML](/de/docs/endpoints/convert/data-formats/csv-to-xml.md) | `POST /v1/convert/csv-to-xml` | Konvertiert CSV zu XML, wobei Spalten-Header zu Element-Tag-Namen werden und jede Zeile als `` innerhalb von `` erscheint. | | [XML zu CSV](/de/docs/endpoints/convert/data-formats/xml-to-csv.md) | `POST /v1/convert/xml-to-csv` | Flacht tabellarisches XML (wiederholte Sibling-Elemente mit konsistenten Feldern) zu kommagetrennten CSV-Zeilen ab. | | [Markdown zu HTML](/de/docs/endpoints/convert/data-formats/markdown-to-html.md) | `POST /v1/convert/markdown-to-html` | Rendert `.md`- oder `.markdown`-Dateien zu einer vollständigen, eigenständigen HTML-Seite mit eingebettetem CSS, Tabellen, Code-Blöcken, TOC-Unterstützung und Dark Mode. | ## Gemeinsame Konventionen - **Authentifizierung:** Jeder Endpunkt akzeptiert entweder einen privaten API-Schlüssel über den `X-API-Key`-Header oder ein JWT-`Authorization: Bearer`-Token, das von einem öffentlichen Schlüssel stammt. Siehe [Authentifizierung](/de/docs/authentication.md). - **Request-Struktur:** Alle Konvertierungen sind synchrone `multipart/form-data`-POSTs mit einem erforderlichen `file`-Feld sowie den optionalen Parametern `output_filename` und `direct_download`. Siehe [Synchrone und asynchrone Jobs](/de/docs/concepts/sync-and-async.md). - **Antworten:** Standardmäßig (`direct_download=true`) wird die konvertierte Datei als rohe Bytes zurückgegeben; mit `direct_download=false` erhältst du JSON-Metadaten mit `presigned_url`, `object_key`, `filename`, `file_size` und `conversion_time_seconds`. - **Eingabeanforderungen:** Alle Eingaben müssen UTF-8-kodiert sein und der erwarteten Dateiendung entsprechen; die maximale Dateigröße ist planabhängig (Founding-Plan: 5 MB). - **Fehler:** Ungültige Dateien oder fehlgeschlagene Konvertierungen liefern `400`, fehlende oder ungültige Zugangsdaten `401`, überschrittene Planlimits `402` und zu große Dateien `413`. Siehe [Fehlercodes](/de/docs/reference/errors.md). ## Häufig gestellte Fragen ### Wie authentifiziere ich Anfragen an die Datenformat-Konvertierungs-Endpunkte? Alle elf Endpunkte akzeptieren entweder einen privaten API-Schlüssel im `X-API-Key`-Header oder ein JWT-`Authorization: Bearer`-Token, das von einem öffentlichen Schlüssel stammt. Dieselben Zugangsdaten funktionieren bei jeder Konvertierung. Details siehe [Authentifizierung](/de/docs/authentication.md). ### Kann ich eine Download-URL statt der konvertierten Datei-Bytes erhalten? Ja. Jeder Endpunkt gibt die konvertierte Datei standardmäßig als rohe Bytes zurück; setze `direct_download=false`, um stattdessen JSON-Metadaten mit `presigned_url`, `object_key`, `filename`, `file_size` und `conversion_time_seconds` zu erhalten. ### Welche Datei- und Eingabegrößenlimits gelten für Datenformat-Konvertierungen? Die maximale Dateigröße ist planabhängig (Founding-Plan: 5 MB); Dateien, die das Limit deines Plans überschreiten, liefern `413 Payload Too Large`. Alle Eingaben müssen UTF-8-kodiert sein, und auch die monatlichen Konvertierungszahlen sind planabhängig. Bei Überschreitung wird `402 Payment Required` zurückgegeben.