mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
This commit is contained in:
SnapOtter
@@ -0,0 +1,53 @@
|
||||
---
|
||||
description: "Erstellt Balken-, Linien- oder Kreisdiagramme aus CSV- oder JSON-Daten."
|
||||
i18n_source_hash: d3c39384457b
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: abda7f7fbe89
|
||||
---
|
||||
|
||||
# Chart Maker {#chart-maker}
|
||||
|
||||
Erstellt Balken-, Linien- oder Kreisdiagramme aus CSV- oder JSON-Daten. Gibt ein PNG-Bild des gerenderten Diagramms zurück.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/chart-maker`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer CSV- oder JSON-Datei und einem JSON-Feld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| kind | string | Nein | `"bar"` | Diagrammtyp: `bar`, `line`, `pie` |
|
||||
| title | string | Nein | - | Diagrammtitel (max. 120 Zeichen) |
|
||||
| width | integer | Nein | `960` | Diagrammbreite in Pixeln (320-2048) |
|
||||
| height | integer | Nein | `540` | Diagrammhöhe in Pixeln (240-1536) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/chart-maker \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@sales.csv" \
|
||||
-F 'settings={"kind": "line", "title": "Monthly Sales", "width": 960, "height": 540}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/sales_chart.png",
|
||||
"originalSize": 1024,
|
||||
"processedSize": 48500
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Die Eingabe muss eine `.csv`- oder `.json`-Datei sein. CSV-Dateien sollten eine Kopfzeile mit Spaltennamen haben.
|
||||
- Die erste Spalte wird als Kategoriebezeichnung verwendet; die zweite Spalte muss numerisch sein und liefert die Datenwerte. Es werden nur zwei Spalten verwendet.
|
||||
- Die JSON-Eingabe sollte ein Array von `{label, value}`-Objekten sein oder ein einfaches Objekt, dessen Schlüssel zu Bezeichnungen und dessen Werte zu Datenpunkten werden.
|
||||
- Maximal 100 Datenpunkte. Alle Werte müssen null oder größer sein.
|
||||
- Die Ausgabe ist unabhängig vom Eingabeformat immer ein PNG-Bild.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Konvertiert zwischen Word-, OpenDocument-, RTF- und Klartextformaten."
|
||||
i18n_source_hash: 89771292569d
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 0c73f2b617c4
|
||||
---
|
||||
|
||||
# Convert Document {#convert-document}
|
||||
|
||||
Konvertiert Dokumente mithilfe von LibreOffice zwischen den Formaten Word (DOCX), OpenDocument (ODT), RTF und Klartext.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-document`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer Word-/ODT-/RTF-/TXT-Datei und einem JSON-Feld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Ja | - | Ausgabeformat: `docx`, `odt`, `rtf`, `txt` |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/convert-document \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@report.docx" \
|
||||
-F 'settings={"format": "odt"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Gibt `202 Accepted` zurück. Verfolge den Fortschritt per SSE unter `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akzeptierte Eingabeformate: `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- Die Konvertierung wird von LibreOffice im Headless-Modus auf dem Server durchgeführt.
|
||||
- Komplexe Formatierungen (Makros, eingebettete Objekte) überstehen die Konvertierung zwischen Formaten möglicherweise nicht.
|
||||
- Das Ausgabeformat muss sich vom Eingabeformat unterscheiden.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Konvertiert zwischen PowerPoint- und OpenDocument-Präsentationsformaten."
|
||||
i18n_source_hash: 08ba415d39ac
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 7c7dc5cd3311
|
||||
---
|
||||
|
||||
# Convert Presentation {#convert-presentation}
|
||||
|
||||
Konvertiert Präsentationen zwischen den Formaten PowerPoint (PPTX) und OpenDocument Presentation (ODP).
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-presentation`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer PowerPoint-/ODP-Datei und einem JSON-Feld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Ja | - | Ausgabeformat: `pptx`, `odp` |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/convert-presentation \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@slides.pptx" \
|
||||
-F 'settings={"format": "odp"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Gibt `202 Accepted` zurück. Verfolge den Fortschritt per SSE unter `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akzeptierte Eingabeformate: `.pptx`, `.ppt`, `.odp`.
|
||||
- Die Konvertierung wird von LibreOffice im Headless-Modus auf dem Server durchgeführt.
|
||||
- Animationen und Übergangseffekte bleiben zwischen Formaten möglicherweise nicht erhalten.
|
||||
- Das Ausgabeformat muss sich vom Eingabeformat unterscheiden.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Konvertiert zwischen Excel-, OpenDocument- und CSV-Formaten."
|
||||
i18n_source_hash: b813b1b06962
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: bd9adfbc6a69
|
||||
---
|
||||
|
||||
# Convert Spreadsheet {#convert-spreadsheet}
|
||||
|
||||
Konvertiert Tabellenkalkulationen zwischen den Formaten Excel (XLSX), OpenDocument Spreadsheet (ODS) und CSV. Bei Arbeitsmappen mit mehreren Blättern wird beim Konvertieren nach CSV das erste Blatt exportiert.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-spreadsheet`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer Excel-/ODS-/CSV-Datei und einem JSON-Feld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Ja | - | Ausgabeformat: `xlsx`, `ods`, `csv` |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/convert-spreadsheet \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@data.xlsx" \
|
||||
-F 'settings={"format": "csv"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Gibt `202 Accepted` zurück. Verfolge den Fortschritt per SSE unter `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akzeptierte Eingabeformate: `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- Beim Konvertieren einer Arbeitsmappe mit mehreren Blättern nach CSV wird nur das erste Blatt exportiert.
|
||||
- Formeln werden ausgewertet und als statische Werte in die CSV-Ausgabe exportiert.
|
||||
- Das Ausgabeformat muss sich vom Eingabeformat unterscheiden.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Bündelt mehrere Dateien in einem einzigen ZIP-Archiv."
|
||||
i18n_source_hash: 9ff1250dbd36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: b89a01fbf2f0
|
||||
---
|
||||
|
||||
# Create ZIP {#create-zip}
|
||||
|
||||
Bündelt mehrere Dateien beliebigen Typs in einem einzigen ZIP-Archiv. Doppelte Dateinamen werden automatisch dedupliziert.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/create-zip`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit zwei oder mehr Dateien. Es ist kein Einstellungsfeld erforderlich.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dieses Tool hat keine konfigurierbaren Parameter. Lade 2-50 Dateien beliebigen Typs zum Bündeln hoch.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/create-zip \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@report.pdf" \
|
||||
-F "file=@data.csv" \
|
||||
-F "file=@photo.jpg"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/archive.zip",
|
||||
"originalSize": 3500000,
|
||||
"processedSize": 2800000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Erfordert zwischen 2 und 50 Eingabedateien.
|
||||
- Jeder Dateityp wird akzeptiert; es gibt keine Einschränkungen beim Eingabeformat.
|
||||
- Wenn mehrere Dateien denselben Namen haben, werden sie automatisch mit numerischen Suffixen dedupliziert.
|
||||
- Das Ausgabearchiv verwendet die Standard-ZIP-Komprimierung (Deflate).
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "Konvertiert zwischen CSV und Excel (XLSX), in beide Richtungen."
|
||||
i18n_source_hash: 213297311e36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 258891f153c3
|
||||
---
|
||||
|
||||
# CSV to Excel {#csv-to-excel}
|
||||
|
||||
Konvertiert zwischen den Formaten CSV und Excel (XLSX) in beide Richtungen. Lade eine CSV- oder TSV-Datei hoch, um XLSX zu erhalten, oder lade eine XLSX-Datei hoch, um CSV zu erhalten.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-excel`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer CSV-, TSV- oder XLSX-Datei und einem JSON-Feld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| sheet | integer | Nein | `1` | Nummer des zu exportierenden Arbeitsblatts beim Konvertieren aus XLSX (min. 1) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
CSV zu Excel:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/csv-excel \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@data.csv" \
|
||||
-F 'settings={"sheet": 1}'
|
||||
```
|
||||
|
||||
Excel zu CSV:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/csv-excel \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@report.xlsx" \
|
||||
-F 'settings={"sheet": 2}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/data.xlsx",
|
||||
"originalSize": 2048,
|
||||
"processedSize": 5120
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Die Konvertierungsrichtung wird automatisch aus der Dateierweiterung der Eingabe erkannt: `.csv` oder `.tsv` erzeugt `.xlsx`, und `.xlsx` erzeugt `.csv`.
|
||||
- Der Parameter `sheet` gilt nur beim Konvertieren aus XLSX. Er wählt aus, welches Arbeitsblatt exportiert wird.
|
||||
- TSV-Dateien (durch Tabulatoren getrennte Werte) werden neben CSV unterstützt.
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
description: "Konvertiert zwischen CSV und JSON, in beide Richtungen."
|
||||
i18n_source_hash: 978c08ad46d3
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 62671e7712c0
|
||||
---
|
||||
|
||||
# CSV to JSON {#csv-to-json}
|
||||
|
||||
Konvertiert zwischen den Formaten CSV und JSON in beide Richtungen. Lade eine CSV- oder TSV-Datei hoch, um ein JSON-Array von Objekten zu erhalten, oder lade ein JSON-Array hoch, um eine CSV-Datei zu erhalten.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-json`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer CSV-, TSV- oder JSON-Datei und einem JSON-Feld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | Nein | `true` | JSON-Ausgabe mit Einrückung formatiert ausgeben |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
CSV zu JSON:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/csv-json \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@users.csv" \
|
||||
-F 'settings={"pretty": true}'
|
||||
```
|
||||
|
||||
JSON zu CSV:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/csv-json \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@users.json" \
|
||||
-F 'settings={}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/users.json",
|
||||
"originalSize": 1500,
|
||||
"processedSize": 2200
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Die Konvertierungsrichtung wird automatisch aus der Dateierweiterung der Eingabe erkannt: `.csv` oder `.tsv` erzeugt `.json`, und `.json` erzeugt `.csv`.
|
||||
- Der Parameter `pretty` wirkt sich nur auf die JSON-Ausgabe aus. Wenn er auf `false` gesetzt ist, ist die Ausgabe ein kompakter, einzeiliger JSON-String.
|
||||
- Die JSON-Eingabe muss ein Array von Objekten mit konsistenten Schlüsseln sein. Jedes Objekt wird zu einer Zeile, und jeder Schlüssel wird zu einer Spaltenüberschrift.
|
||||
- TSV-Dateien (durch Tabulatoren getrennte Werte) werden neben CSV unterstützt.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Konvertiert ein EPUB in PDF, DOCX, HTML oder Markdown."
|
||||
i18n_source_hash: 7d94fc18ca97
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2af5c980e761
|
||||
---
|
||||
|
||||
# Convert EPUB {#convert-epub}
|
||||
|
||||
Konvertiert ein EPUB-E-Book in PDF, Word (DOCX), HTML oder Markdown. Entfernte Ressourcen im Buch werden nicht abgerufen.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/epub-convert`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer EPUB-Datei und einem JSON-Feld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Ja | - | Ausgabeformat: `pdf`, `docx`, `html`, `md` |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/epub-convert \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@book.epub" \
|
||||
-F 'settings={"format": "pdf"}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Gibt `202 Accepted` zurück. Verfolge den Fortschritt per SSE unter `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akzeptiertes Eingabeformat: `.epub`.
|
||||
- Entfernte, im EPUB eingebettete Ressourcen (externe Bilder, Schriftarten) werden aus Sicherheitsgründen nicht abgerufen.
|
||||
- Die Bildtreue in der konvertierten Ausgabe kann je nach EPUB-Struktur variieren.
|
||||
- Die Konvertierung wird von Pandoc auf dem Server durchgeführt.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Konvertiert Tabellenkalkulationen in PDF."
|
||||
i18n_source_hash: 4dbe2a810ea6
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: faf8c85d9895
|
||||
---
|
||||
|
||||
# Excel to PDF {#excel-to-pdf}
|
||||
|
||||
Konvertiert Excel-, OpenDocument- oder CSV-Tabellenkalkulationen in PDF. Breite Blätter können über mehrere Seiten paginiert werden.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/excel-to-pdf`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer Excel-/ODS-/CSV-Datei.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dieses Tool hat keine konfigurierbaren Parameter. Lade eine Tabellenkalkulation hoch, und sie wird in PDF konvertiert.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/excel-to-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@budget.xlsx"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Gibt `202 Accepted` zurück. Verfolge den Fortschritt per SSE unter `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akzeptierte Eingabeformate: `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- Breite Blätter können im resultierenden PDF über mehrere Seiten aufgeteilt werden.
|
||||
- Diagramme und bedingte Formatierungen werden in der PDF-Ausgabe gerendert.
|
||||
- Die Konvertierung wird von LibreOffice im Headless-Modus auf dem Server durchgeführt.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Extrahiert Dateien sicher aus einem ZIP-Archiv mit Schutz vor ZIP-Bomben."
|
||||
i18n_source_hash: 484a1f1051b8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: cbe8d2261f96
|
||||
---
|
||||
|
||||
# Extract ZIP {#extract-zip}
|
||||
|
||||
Extrahiert Dateien sicher aus einem ZIP-Archiv. Archive mit einer einzelnen Datei geben die enthaltene Datei direkt zurück; Archive mit mehreren Dateien geben ein flaches ZIP mit den extrahierten Inhalten zurück.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/extract-zip`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer ZIP-Datei. Es ist kein Einstellungsfeld erforderlich.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dieses Tool hat keine konfigurierbaren Parameter. Lade eine `.zip`-Datei zum Extrahieren hoch.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/extract-zip \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@archive.zip"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/archive_extracted.zip",
|
||||
"originalSize": 2800000,
|
||||
"processedSize": 3500000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Nur `.zip`-Dateien werden als Eingabe akzeptiert.
|
||||
- Wenn das Archiv eine einzelne Datei enthält, wird diese Datei direkt zurückgegeben (nicht in ein ZIP verpackt).
|
||||
- Wenn das Archiv mehrere Dateien enthält, wird ein flaches ZIP zurückgegeben, in dem alle Dateien auf die Wurzelebene extrahiert werden (die verschachtelte Verzeichnisstruktur wird abgeflacht).
|
||||
- Der integrierte Schutz vor ZIP-Bomben lehnt Archive mit übermäßigen Komprimierungsverhältnissen oder Dateianzahlen ab, um Ressourcenerschöpfung zu verhindern.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Konvertiert eine HTML-Datei in PDF."
|
||||
i18n_source_hash: 20b9ae147db5
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 3c147738d773
|
||||
---
|
||||
|
||||
# HTML to PDF {#html-to-pdf}
|
||||
|
||||
Konvertiert eine HTML-Datei in ein gestaltetes PDF-Dokument. Entfernte Ressourcen (externe Bilder, Stylesheets, Skripte) sind aus Datenschutzgründen deaktiviert.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/html-to-pdf`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer HTML-Datei.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dieses Tool hat keine konfigurierbaren Parameter. Lade eine HTML-Datei hoch, und sie wird in PDF konvertiert.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/html-to-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@page.html"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
Gibt `202 Accepted` zurück. Verfolge den Fortschritt per SSE unter `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akzeptierte Eingabeformate: `.html`, `.htm`.
|
||||
- Entfernte Ressourcen (Bilder, Stylesheets, über URLs referenzierte Skripte) werden aus Datenschutz- und Sicherheitsgründen nicht abgerufen.
|
||||
- Inline-Stile und eingebettete Bilder (Data-URIs) bleiben erhalten.
|
||||
- Die Konvertierung wird von WeasyPrint auf dem Server durchgeführt.
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "Konvertiert zwischen JSON und XML, in beide Richtungen."
|
||||
i18n_source_hash: b3a6ded0c64a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: a13754d9a95d
|
||||
---
|
||||
|
||||
# JSON to XML {#json-to-xml}
|
||||
|
||||
Konvertiert zwischen den Formaten JSON und XML in beide Richtungen. Lade eine JSON-Datei hoch, um XML zu erhalten, oder lade eine XML-Datei hoch, um JSON zu erhalten.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/json-xml`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer JSON- oder XML-Datei und einem JSON-Feld `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | Nein | `true` | Ausgabe mit Einrückung formatiert ausgeben |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
JSON zu XML:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/json-xml \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@config.json" \
|
||||
-F 'settings={"pretty": true}'
|
||||
```
|
||||
|
||||
XML zu JSON:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/json-xml \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@config.xml" \
|
||||
-F 'settings={"pretty": true}'
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.xml",
|
||||
"originalSize": 850,
|
||||
"processedSize": 1200
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Die Konvertierungsrichtung wird automatisch aus der Dateierweiterung der Eingabe erkannt: `.json` erzeugt `.xml`, und `.xml` erzeugt `.json`.
|
||||
- Der Parameter `pretty` gilt für beide Richtungen. Bei `false` ist die Ausgabe kompakt und ohne Einrückung.
|
||||
- XML-Attribute und verschachtelte Strukturen bleiben bei der Hin- und Rückkonvertierung nach Möglichkeit erhalten.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Konvertiert eine Markdown-Datei in ein Word-Dokument (DOCX)."
|
||||
i18n_source_hash: 979cb8ee13f2
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: a45b2bda275c
|
||||
---
|
||||
|
||||
# Markdown to Word {#markdown-to-word}
|
||||
|
||||
Konvertiert eine Markdown-Datei in ein Word-Dokument (DOCX) und behält dabei Überschriften, Listen, Codeblöcke und andere Formatierungen bei.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-docx`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer Markdown-Datei.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dieses Tool hat keine konfigurierbaren Parameter. Lade eine Markdown-Datei hoch, und sie wird in DOCX konvertiert.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/markdown-to-docx \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@README.md"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/README.docx",
|
||||
"originalSize": 4500,
|
||||
"processedSize": 18200
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akzeptierte Eingabeformate: `.md`, `.markdown`.
|
||||
- Dies ist ein schnelles (synchrones) Tool, das das Ergebnis direkt zurückgibt.
|
||||
- Überschriften, Fett, Kursiv, Links, Codeblöcke und Listen werden auf Word-Formatvorlagen abgebildet.
|
||||
- Die Konvertierung wird von Pandoc auf dem Server durchgeführt.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Konvertiert eine Markdown-Datei in eine eigenständige HTML-Seite."
|
||||
i18n_source_hash: 3ef805e8fc8c
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 48665f70348f
|
||||
---
|
||||
|
||||
# Markdown to HTML {#markdown-to-html}
|
||||
|
||||
Konvertiert eine Markdown-Datei in eine eigenständige HTML-Seite. Im Quelltext referenzierte entfernte Bilder werden in der Ausgabe unverändert belassen.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-html`
|
||||
|
||||
Akzeptiert Multipart-Formulardaten mit einer Markdown-Datei.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Dieses Tool hat keine konfigurierbaren Parameter. Lade eine Markdown-Datei hoch, und sie wird in HTML konvertiert.
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/markdown-to-html \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@notes.md"
|
||||
```
|
||||
|
||||
## Example Response {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/notes.html",
|
||||
"originalSize": 3200,
|
||||
"processedSize": 5800
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akzeptierte Eingabeformate: `.md`, `.markdown`.
|
||||
- Dies ist ein schnelles (synchrones) Tool, das das Ergebnis direkt zurückgibt.
|
||||
- Die Ausgabe ist eine in sich geschlossene HTML-Seite mit Inline-Stilen.
|
||||
- Entfernte Bild-URLs im Markdown-Quelltext bleiben unverändert erhalten und werden nicht abgerufen.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Eine Markdown-Datei in ein formatiertes PDF umwandeln."
|
||||
i18n_source_hash: 18474dc8772a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2c4c1e256e6a
|
||||
---
|
||||
|
||||
# Markdown zu PDF {#markdown-to-pdf}
|
||||
|
||||
Wandelt eine Markdown-Datei in ein formatiertes PDF-Dokument um. Aus Datenschutzgründen sind entfernte Ressourcen deaktiviert.
|
||||
|
||||
## API-Endpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-pdf`
|
||||
|
||||
Nimmt Multipart-Formulardaten mit einer Markdown-Datei entgegen.
|
||||
|
||||
## Parameter {#parameters}
|
||||
|
||||
Dieses Werkzeug hat keine konfigurierbaren Parameter. Laden Sie eine Markdown-Datei hoch, und sie wird in ein PDF umgewandelt.
|
||||
|
||||
## Beispielanfrage {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/markdown-to-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@document.md"
|
||||
```
|
||||
|
||||
## Beispielantwort {#example-response}
|
||||
|
||||
Gibt `202 Accepted` zurück. Verfolgen Sie den Fortschritt per SSE unter `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Hinweise {#notes}
|
||||
|
||||
- Akzeptierte Eingabeformate: `.md`, `.markdown`.
|
||||
- Aus Datenschutz- und Sicherheitsgründen werden entfernte Ressourcen (über URLs referenzierte Bilder, Stylesheets) nicht abgerufen.
|
||||
- Das Markdown wird zunächst in HTML gerendert und anschließend über WeasyPrint in ein PDF umgewandelt.
|
||||
- Codeblöcke, Tabellen und andere Markdown-Elemente werden in der PDF-Ausgabe formatiert.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Mehrere CSV- oder TSV-Dateien mit übereinstimmenden Spalten zu einer einzigen zusammenführen."
|
||||
i18n_source_hash: 109b5f399ac8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 33951aeb8d6c
|
||||
---
|
||||
|
||||
# CSVs zusammenführen {#merge-csvs}
|
||||
|
||||
Fügt mehrere CSV- oder TSV-Dateien mit übereinstimmenden Spalten zu einer einzigen zusammengeführten Datei zusammen. Alle Eingabedateien müssen dieselben Spaltenüberschriften haben.
|
||||
|
||||
## API-Endpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/merge-csvs`
|
||||
|
||||
Nimmt Multipart-Formulardaten mit zwei oder mehr CSV-Dateien entgegen. Es ist kein settings-Feld erforderlich.
|
||||
|
||||
## Parameter {#parameters}
|
||||
|
||||
Dieses Werkzeug hat keine konfigurierbaren Parameter. Laden Sie 2 bis 20 CSV- oder TSV-Dateien mit übereinstimmenden Spaltenüberschriften hoch.
|
||||
|
||||
## Beispielanfrage {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/merge-csvs \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@january.csv" \
|
||||
-F "file=@february.csv" \
|
||||
-F "file=@march.csv"
|
||||
```
|
||||
|
||||
## Beispielantwort {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.csv",
|
||||
"originalSize": 30000,
|
||||
"processedSize": 28500
|
||||
}
|
||||
```
|
||||
|
||||
## Hinweise {#notes}
|
||||
|
||||
- Erfordert zwischen 2 und 20 Eingabedateien.
|
||||
- Alle Dateien müssen dieselben Spaltenüberschriften haben. Die Zusammenführung schlägt fehl, wenn die Spalten nicht übereinstimmen.
|
||||
- Die Kopfzeile wird in der Ausgabe einmal aufgenommen; die Datenzeilen aller Dateien werden in der Reihenfolge des Uploads aneinandergehängt.
|
||||
- Sowohl CSV- als auch TSV-Dateien werden akzeptiert, doch alle Dateien einer einzelnen Anfrage sollten dasselbe Trennzeichen verwenden.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Präsentationen in PDF umwandeln."
|
||||
i18n_source_hash: 49bd71c46bed
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: eff48ebbd486
|
||||
---
|
||||
|
||||
# PowerPoint zu PDF {#powerpoint-to-pdf}
|
||||
|
||||
Wandelt PowerPoint- oder OpenDocument-Präsentationen in ein PDF um, mit einer Folie pro Seite.
|
||||
|
||||
## API-Endpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/powerpoint-to-pdf`
|
||||
|
||||
Nimmt Multipart-Formulardaten mit einer PowerPoint-/ODP-Datei entgegen.
|
||||
|
||||
## Parameter {#parameters}
|
||||
|
||||
Dieses Werkzeug hat keine konfigurierbaren Parameter. Laden Sie eine Präsentation hoch, und sie wird in ein PDF umgewandelt.
|
||||
|
||||
## Beispielanfrage {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/powerpoint-to-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@slides.pptx"
|
||||
```
|
||||
|
||||
## Beispielantwort {#example-response}
|
||||
|
||||
Gibt `202 Accepted` zurück. Verfolgen Sie den Fortschritt per SSE unter `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Hinweise {#notes}
|
||||
|
||||
- Akzeptierte Eingabeformate: `.pptx`, `.ppt`, `.odp`.
|
||||
- Jede Folie wird zu einer Seite im PDF.
|
||||
- Die Umwandlung übernimmt LibreOffice, das auf dem Server im Headless-Modus läuft.
|
||||
- Animationen und Übergänge sind in der PDF-Ausgabe nicht enthalten.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Eine CSV nach Zeilenanzahl in kleinere Dateien aufteilen."
|
||||
i18n_source_hash: a35dce4a99a3
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 6d9c3a382794
|
||||
---
|
||||
|
||||
# CSV aufteilen {#split-csv}
|
||||
|
||||
Teilt eine große CSV- oder TSV-Datei nach Zeilenanzahl in kleinere Dateien auf. Gibt ein ZIP-Archiv mit den Teilen zurück.
|
||||
|
||||
## API-Endpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/split-csv`
|
||||
|
||||
Nimmt Multipart-Formulardaten mit einer CSV-Datei und einem JSON-Feld `settings` entgegen.
|
||||
|
||||
## Parameter {#parameters}
|
||||
|
||||
| Parameter | Typ | Erforderlich | Standard | Beschreibung |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| rowsPerFile | integer | Nein | `1000` | Anzahl der Datenzeilen pro Ausgabedatei (1-1.000.000) |
|
||||
| keepHeader | boolean | Nein | `true` | Die Kopfzeile in jeder Ausgabedatei wiederholen |
|
||||
|
||||
## Beispielanfrage {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/split-csv \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@large-dataset.csv" \
|
||||
-F 'settings={"rowsPerFile": 500, "keepHeader": true}'
|
||||
```
|
||||
|
||||
## Beispielantwort {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/large-dataset_parts.zip",
|
||||
"originalSize": 1048576,
|
||||
"processedSize": 1050000
|
||||
}
|
||||
```
|
||||
|
||||
## Hinweise {#notes}
|
||||
|
||||
- Die Ausgabe ist immer ein ZIP-Archiv mit den aufgeteilten CSV-Teilen, die fortlaufend benannt sind (z. B. `part-1.csv`, `part-2.csv`).
|
||||
- Wenn `keepHeader` auf `true` steht, enthält jeder Teil die ursprüngliche Kopfzeile, sodass jede Datei eigenständig verwendet werden kann.
|
||||
- Sowohl CSV- als auch TSV-Dateien werden als Eingabe akzeptiert.
|
||||
- Die Zeilenanzahl bezieht sich nur auf Datenzeilen; die Kopfzeile wird nicht mitgezählt.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Word-, Markdown-, HTML- oder Klartextdateien in EPUB umwandeln."
|
||||
i18n_source_hash: 63e1afa91c52
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: c06baec84ade
|
||||
---
|
||||
|
||||
# In EPUB umwandeln {#convert-to-epub}
|
||||
|
||||
Wandelt Word-Dokumente, Markdown, HTML oder Klartextdateien in das E-Book-Format EPUB um.
|
||||
|
||||
## API-Endpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/to-epub`
|
||||
|
||||
Nimmt Multipart-Formulardaten mit einer Word-/Markdown-/HTML-/TXT-Datei entgegen.
|
||||
|
||||
## Parameter {#parameters}
|
||||
|
||||
Dieses Werkzeug hat keine konfigurierbaren Parameter. Laden Sie ein Dokument hoch, und es wird in ein EPUB umgewandelt.
|
||||
|
||||
## Beispielanfrage {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/to-epub \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@manuscript.docx"
|
||||
```
|
||||
|
||||
## Beispielantwort {#example-response}
|
||||
|
||||
Gibt `202 Accepted` zurück. Verfolgen Sie den Fortschritt per SSE unter `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Hinweise {#notes}
|
||||
|
||||
- Akzeptierte Eingabeformate: `.docx`, `.md`, `.html`, `.txt`.
|
||||
- Die EPUB-Ausgabe folgt der Spezifikation EPUB 3.
|
||||
- Überschriften im Quelldokument werden zum Erzeugen des Inhaltsverzeichnisses verwendet.
|
||||
- Die Umwandlung übernimmt Pandoc auf dem Server.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Word-Dokumente in PDF umwandeln."
|
||||
i18n_source_hash: f814ba1a1a53
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 9bd1eed251de
|
||||
---
|
||||
|
||||
# Word zu PDF {#word-to-pdf}
|
||||
|
||||
Wandelt Word-Dokumente, OpenDocument-Text, RTF oder Klartextdateien in ein PDF um.
|
||||
|
||||
## API-Endpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/word-to-pdf`
|
||||
|
||||
Nimmt Multipart-Formulardaten mit einer Word-/ODT-/RTF-/TXT-Datei entgegen.
|
||||
|
||||
## Parameter {#parameters}
|
||||
|
||||
Dieses Werkzeug hat keine konfigurierbaren Parameter. Laden Sie ein Dokument hoch, und es wird in ein PDF umgewandelt.
|
||||
|
||||
## Beispielanfrage {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/word-to-pdf \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@report.docx"
|
||||
```
|
||||
|
||||
## Beispielantwort {#example-response}
|
||||
|
||||
Gibt `202 Accepted` zurück. Verfolgen Sie den Fortschritt per SSE unter `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Hinweise {#notes}
|
||||
|
||||
- Akzeptierte Eingabeformate: `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- Die Umwandlung übernimmt LibreOffice, das auf dem Server im Headless-Modus läuft.
|
||||
- In das Dokument eingebettete Schriftarten werden verwendet, sofern verfügbar; andernfalls werden Systemschriftarten ersetzt.
|
||||
- Kopf- und Fußzeilen, Tabellen und Bilder bleiben in der PDF-Ausgabe erhalten.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Sich wiederholende Elemente aus XML in eine CSV-Tabelle extrahieren."
|
||||
i18n_source_hash: 3ab1019bff8a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 492d543e1a85
|
||||
---
|
||||
|
||||
# XML zu CSV {#xml-to-csv}
|
||||
|
||||
Extrahiert sich wiederholende Elemente aus einer XML-Datei in eine flache CSV-Tabelle. Das Werkzeug findet automatisch das erste Array von Objekten im XML-Baum und ordnet jedes Element einer Zeile zu.
|
||||
|
||||
## API-Endpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/xml-to-csv`
|
||||
|
||||
Nimmt Multipart-Formulardaten mit einer XML-Datei entgegen. Es ist kein settings-Feld erforderlich.
|
||||
|
||||
## Parameter {#parameters}
|
||||
|
||||
Dieses Werkzeug hat keine konfigurierbaren Parameter. Das sich wiederholende Element wird automatisch aus der XML-Struktur erkannt.
|
||||
|
||||
## Beispielanfrage {#example-request}
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/xml-to-csv \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@catalog.xml"
|
||||
```
|
||||
|
||||
## Beispielantwort {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/catalog.csv",
|
||||
"originalSize": 4500,
|
||||
"processedSize": 1800
|
||||
}
|
||||
```
|
||||
|
||||
## Hinweise {#notes}
|
||||
|
||||
- Nur `.xml`-Dateien werden als Eingabe akzeptiert.
|
||||
- Das Werkzeug durchsucht den XML-Baum nach der ersten sich wiederholenden Menge gleichrangiger Elemente und verwendet diese als Zeilen.
|
||||
- Jeder eindeutige Name eines Kindelements oder Attributs wird zu einer CSV-Spaltenüberschrift.
|
||||
- Dies ist eine einseitige Umwandlung. Für eine bidirektionale JSON-/XML-Umwandlung verwenden Sie das Werkzeug [JSON zu XML](/de/tools/files/json-xml).
|
||||
@@ -0,0 +1,55 @@
|
||||
---
|
||||
description: "In beide Richtungen zwischen YAML und JSON umwandeln."
|
||||
i18n_source_hash: acf8ca21ee99
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 90e892bde21b
|
||||
---
|
||||
|
||||
# YAML / JSON {#yaml-json}
|
||||
|
||||
Wandelt in beide Richtungen zwischen den Formaten YAML und JSON um. Laden Sie eine YAML-Datei hoch, um JSON zu erhalten, oder laden Sie eine JSON-Datei hoch, um YAML zu erhalten.
|
||||
|
||||
## API-Endpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/yaml-json`
|
||||
|
||||
Nimmt Multipart-Formulardaten mit einer YAML- oder JSON-Datei entgegen. Es ist kein settings-Feld erforderlich.
|
||||
|
||||
## Parameter {#parameters}
|
||||
|
||||
Dieses Werkzeug hat keine konfigurierbaren Parameter. Die Umwandlungsrichtung wird anhand der Dateiendung der Eingabe bestimmt.
|
||||
|
||||
## Beispielanfrage {#example-request}
|
||||
|
||||
YAML zu JSON:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/yaml-json \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@config.yaml"
|
||||
```
|
||||
|
||||
JSON zu YAML:
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:1349/api/v1/tools/files/yaml-json \
|
||||
-H "Authorization: Bearer si_your-api-key" \
|
||||
-F "file=@config.json"
|
||||
```
|
||||
|
||||
## Beispielantwort {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.json",
|
||||
"originalSize": 620,
|
||||
"processedSize": 780
|
||||
}
|
||||
```
|
||||
|
||||
## Hinweise {#notes}
|
||||
|
||||
- Die Umwandlungsrichtung wird automatisch anhand der Dateiendung der Eingabe erkannt: `.yaml` oder `.yml` erzeugt `.json`, und `.json` erzeugt `.yaml`.
|
||||
- Sowohl die Endung `.yaml` als auch `.yml` wird akzeptiert.
|
||||
- Nur das erste Dokument einer YAML-Datei mit mehreren Dokumenten wird umgewandelt; weitere, durch `---` getrennte Dokumente werden ignoriert.
|
||||
Reference in New Issue
Block a user