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: "Tworzy wykresy słupkowe, liniowe lub kołowe z danych CSV lub JSON."
|
||||
i18n_source_hash: d3c39384457b
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 25849f2b1af2
|
||||
---
|
||||
|
||||
# Chart Maker {#chart-maker}
|
||||
|
||||
Tworzy wykresy słupkowe, liniowe lub kołowe z danych CSV lub JSON. Zwraca obraz PNG z wyrenderowanym wykresem.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/chart-maker`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem CSV lub JSON oraz polem JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parametr | Typ | Wymagany | Domyślny | Opis |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| kind | string | Nie | `"bar"` | Typ wykresu: `bar`, `line`, `pie` |
|
||||
| title | string | Nie | - | Tytuł wykresu (maks. 120 znaków) |
|
||||
| width | integer | Nie | `960` | Szerokość wykresu w pikselach (320-2048) |
|
||||
| height | integer | Nie | `540` | Wysokość wykresu w pikselach (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}
|
||||
|
||||
- Wejściem musi być plik `.csv` lub `.json`. Pliki CSV powinny mieć wiersz nagłówka z nazwami kolumn.
|
||||
- Pierwsza kolumna jest używana jako etykieta kategorii; druga kolumna musi być liczbowa i dostarcza wartości danych. Używane są tylko dwie kolumny.
|
||||
- Wejście JSON powinno być tablicą obiektów `{label, value}` lub zwykłym obiektem, którego klucze stają się etykietami, a wartości punktami danych.
|
||||
- Maksymalnie 100 punktów danych. Wszystkie wartości muszą być zerowe lub większe.
|
||||
- Wynikiem jest zawsze obraz PNG, niezależnie od formatu wejściowego.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Konwertuje między formatami Word, OpenDocument, RTF i zwykłego tekstu."
|
||||
i18n_source_hash: 89771292569d
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: ca05a71bfc27
|
||||
---
|
||||
|
||||
# Convert Document {#convert-document}
|
||||
|
||||
Konwertuje dokumenty między formatami Word (DOCX), OpenDocument (ODT), RTF i zwykłego tekstu przy użyciu LibreOffice.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-document`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem Word/ODT/RTF/TXT oraz polem JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parametr | Typ | Wymagany | Domyślny | Opis |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Tak | - | Format wyjściowy: `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}
|
||||
|
||||
Zwraca `202 Accepted`. Śledź postęp przez SSE pod `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akceptowane formaty wejściowe: `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- Konwersję obsługuje LibreOffice działający w trybie headless na serwerze.
|
||||
- Złożone formatowanie (makra, obiekty osadzone) może nie przetrwać konwersji między formatami.
|
||||
- Format wyjściowy musi różnić się od formatu wejściowego.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Konwertuje między formatami prezentacji PowerPoint i OpenDocument."
|
||||
i18n_source_hash: 08ba415d39ac
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 30ef3616cb4e
|
||||
---
|
||||
|
||||
# Convert Presentation {#convert-presentation}
|
||||
|
||||
Konwertuje prezentacje między formatami PowerPoint (PPTX) i OpenDocument Presentation (ODP).
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-presentation`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem PowerPoint/ODP oraz polem JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parametr | Typ | Wymagany | Domyślny | Opis |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Tak | - | Format wyjściowy: `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}
|
||||
|
||||
Zwraca `202 Accepted`. Śledź postęp przez SSE pod `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akceptowane formaty wejściowe: `.pptx`, `.ppt`, `.odp`.
|
||||
- Konwersję obsługuje LibreOffice działający w trybie headless na serwerze.
|
||||
- Animacje i efekty przejść mogą nie zostać zachowane między formatami.
|
||||
- Format wyjściowy musi różnić się od formatu wejściowego.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Konwertuje między formatami Excel, OpenDocument i CSV."
|
||||
i18n_source_hash: b813b1b06962
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 08805f0ab779
|
||||
---
|
||||
|
||||
# Convert Spreadsheet {#convert-spreadsheet}
|
||||
|
||||
Konwertuje arkusze kalkulacyjne między formatami Excel (XLSX), OpenDocument Spreadsheet (ODS) i CSV. Skoroszyty wieloarkuszowe eksportują pierwszy arkusz podczas konwersji do CSV.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-spreadsheet`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem Excel/ODS/CSV oraz polem JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parametr | Typ | Wymagany | Domyślny | Opis |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Tak | - | Format wyjściowy: `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}
|
||||
|
||||
Zwraca `202 Accepted`. Śledź postęp przez SSE pod `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akceptowane formaty wejściowe: `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- Podczas konwersji skoroszytu wieloarkuszowego do CSV eksportowany jest tylko pierwszy arkusz.
|
||||
- Formuły są obliczane i eksportowane jako wartości statyczne w wyniku CSV.
|
||||
- Format wyjściowy musi różnić się od formatu wejściowego.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Pakuje wiele plików w jedno archiwum ZIP."
|
||||
i18n_source_hash: 9ff1250dbd36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 28164bf351bd
|
||||
---
|
||||
|
||||
# Create ZIP {#create-zip}
|
||||
|
||||
Pakuje wiele plików dowolnego typu w jedno archiwum ZIP. Zduplikowane nazwy plików są automatycznie deduplikowane.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/create-zip`
|
||||
|
||||
Przyjmuje dane formularza multipart z dwoma lub więcej plikami. Pole ustawień nie jest wymagane.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Prześlij od 2 do 50 plików dowolnego typu do spakowania.
|
||||
|
||||
## 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}
|
||||
|
||||
- Wymaga od 2 do 50 plików wejściowych.
|
||||
- Akceptowany jest dowolny typ pliku; nie ma ograniczeń co do formatu wejściowego.
|
||||
- Jeśli kilka plików ma tę samą nazwę, są one automatycznie deduplikowane przez dodanie sufiksów liczbowych.
|
||||
- Archiwum wyjściowe korzysta ze standardowej kompresji ZIP (deflate).
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "Konwertuje między CSV a Excel (XLSX) w obu kierunkach."
|
||||
i18n_source_hash: 213297311e36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 4daab9e32ab9
|
||||
---
|
||||
|
||||
# CSV to Excel {#csv-to-excel}
|
||||
|
||||
Konwertuje między formatami CSV a Excel (XLSX) w obu kierunkach. Prześlij plik CSV lub TSV, aby otrzymać XLSX, albo prześlij plik XLSX, aby otrzymać CSV.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-excel`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem CSV, TSV lub XLSX oraz polem JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parametr | Typ | Wymagany | Domyślny | Opis |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| sheet | integer | Nie | `1` | Numer arkusza do wyeksportowania podczas konwersji z XLSX (min. 1) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
CSV na 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 na 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}
|
||||
|
||||
- Kierunek konwersji jest automatycznie wykrywany na podstawie rozszerzenia pliku wejściowego: `.csv` lub `.tsv` tworzy `.xlsx`, a `.xlsx` tworzy `.csv`.
|
||||
- Parametr `sheet` ma zastosowanie tylko podczas konwersji z XLSX. Wybiera arkusz do wyeksportowania.
|
||||
- Pliki TSV (wartości rozdzielane tabulatorami) są obsługiwane obok CSV.
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
description: "Konwertuje między CSV a JSON w obu kierunkach."
|
||||
i18n_source_hash: 978c08ad46d3
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 26c25e28620d
|
||||
---
|
||||
|
||||
# CSV to JSON {#csv-to-json}
|
||||
|
||||
Konwertuje między formatami CSV a JSON w obu kierunkach. Prześlij plik CSV lub TSV, aby otrzymać tablicę obiektów JSON, albo prześlij tablicę JSON, aby otrzymać plik CSV.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-json`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem CSV, TSV lub JSON oraz polem JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parametr | Typ | Wymagany | Domyślny | Opis |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | Nie | `true` | Formatuje wynik JSON z wcięciami dla czytelności |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
CSV na 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 na 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}
|
||||
|
||||
- Kierunek konwersji jest automatycznie wykrywany na podstawie rozszerzenia pliku wejściowego: `.csv` lub `.tsv` tworzy `.json`, a `.json` tworzy `.csv`.
|
||||
- Parametr `pretty` wpływa tylko na wynik JSON. Ustawiony na `false` powoduje, że wynikiem jest zwarty jednowierszowy ciąg JSON.
|
||||
- Wejście JSON musi być tablicą obiektów o spójnych kluczach. Każdy obiekt staje się wierszem, a każdy klucz nagłówkiem kolumny.
|
||||
- Pliki TSV (wartości rozdzielane tabulatorami) są obsługiwane obok CSV.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Konwertuje EPUB na PDF, DOCX, HTML lub Markdown."
|
||||
i18n_source_hash: 7d94fc18ca97
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: bb167806f277
|
||||
---
|
||||
|
||||
# Convert EPUB {#convert-epub}
|
||||
|
||||
Konwertuje e-booka EPUB na PDF, Word (DOCX), HTML lub Markdown. Zasoby zdalne wewnątrz książki nie są pobierane.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/epub-convert`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem EPUB oraz polem JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parametr | Typ | Wymagany | Domyślny | Opis |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Tak | - | Format wyjściowy: `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}
|
||||
|
||||
Zwraca `202 Accepted`. Śledź postęp przez SSE pod `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akceptowany format wejściowy: `.epub`.
|
||||
- Zasoby zdalne osadzone w EPUB (zewnętrzne obrazy, czcionki) nie są pobierane ze względów bezpieczeństwa.
|
||||
- Wierność obrazów w wyniku konwersji może się różnić w zależności od struktury EPUB.
|
||||
- Konwersję obsługuje Pandoc na serwerze.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Konwertuje arkusze kalkulacyjne na PDF."
|
||||
i18n_source_hash: 4dbe2a810ea6
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 70e724345947
|
||||
---
|
||||
|
||||
# Excel to PDF {#excel-to-pdf}
|
||||
|
||||
Konwertuje arkusze kalkulacyjne Excel, OpenDocument lub CSV na PDF. Szerokie arkusze mogą być dzielone na wiele stron.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/excel-to-pdf`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem Excel/ODS/CSV.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Prześlij arkusz kalkulacyjny, a zostanie on przekonwertowany na PDF.
|
||||
|
||||
## 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}
|
||||
|
||||
Zwraca `202 Accepted`. Śledź postęp przez SSE pod `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akceptowane formaty wejściowe: `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- Szerokie arkusze mogą zostać podzielone na wiele stron w wynikowym PDF.
|
||||
- Wykresy i formatowanie warunkowe są renderowane w wyniku PDF.
|
||||
- Konwersję obsługuje LibreOffice działający w trybie headless na serwerze.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Bezpiecznie wypakowuje pliki z archiwum ZIP z ochroną przed bombami."
|
||||
i18n_source_hash: 484a1f1051b8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: e4a94b89b6d3
|
||||
---
|
||||
|
||||
# Extract ZIP {#extract-zip}
|
||||
|
||||
Bezpiecznie wypakowuje pliki z archiwum ZIP. Archiwa jednoplikowe zwracają zawarty plik bezpośrednio; archiwa wieloplikowe zwracają płaski ZIP z wypakowaną zawartością.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/extract-zip`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem ZIP. Pole ustawień nie jest wymagane.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Prześlij plik `.zip` do wypakowania.
|
||||
|
||||
## 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}
|
||||
|
||||
- Jako wejście akceptowane są tylko pliki `.zip`.
|
||||
- Jeśli archiwum zawiera pojedynczy plik, jest on zwracany bezpośrednio (nie jest zawijany w ZIP).
|
||||
- Jeśli archiwum zawiera wiele plików, zwracany jest płaski ZIP ze wszystkimi plikami wypakowanymi do poziomu głównego (zagnieżdżona struktura katalogów jest spłaszczana).
|
||||
- Wbudowana ochrona przed bombami odrzuca archiwa o nadmiernych współczynnikach kompresji lub liczbie plików, aby zapobiec wyczerpaniu zasobów.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Konwertuje plik HTML na PDF."
|
||||
i18n_source_hash: 20b9ae147db5
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: c847ece23f89
|
||||
---
|
||||
|
||||
# HTML to PDF {#html-to-pdf}
|
||||
|
||||
Konwertuje plik HTML na sformatowany dokument PDF. Zasoby zdalne (zewnętrzne obrazy, arkusze stylów, skrypty) są wyłączone ze względu na prywatność.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/html-to-pdf`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem HTML.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Prześlij plik HTML, a zostanie on przekonwertowany na PDF.
|
||||
|
||||
## 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}
|
||||
|
||||
Zwraca `202 Accepted`. Śledź postęp przez SSE pod `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Akceptowane formaty wejściowe: `.html`, `.htm`.
|
||||
- Zasoby zdalne (obrazy, arkusze stylów, skrypty wskazywane przez adresy URL) nie są pobierane ze względów prywatności i bezpieczeństwa.
|
||||
- Style wpisane bezpośrednio i osadzone obrazy (data URI) są zachowywane.
|
||||
- Konwersję obsługuje WeasyPrint na serwerze.
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "Konwertuje między JSON a XML w obu kierunkach."
|
||||
i18n_source_hash: b3a6ded0c64a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: c2acfb37cdf4
|
||||
---
|
||||
|
||||
# JSON to XML {#json-to-xml}
|
||||
|
||||
Konwertuje między formatami JSON a XML w obu kierunkach. Prześlij plik JSON, aby otrzymać XML, albo prześlij plik XML, aby otrzymać JSON.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/json-xml`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem JSON lub XML oraz polem JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parametr | Typ | Wymagany | Domyślny | Opis |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | Nie | `true` | Formatuje wynik z wcięciami dla czytelności |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
JSON na 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 na 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}
|
||||
|
||||
- Kierunek konwersji jest automatycznie wykrywany na podstawie rozszerzenia pliku wejściowego: `.json` tworzy `.xml`, a `.xml` tworzy `.json`.
|
||||
- Parametr `pretty` ma zastosowanie w obu kierunkach. Gdy `false`, wynik jest zwarty i bez wcięć.
|
||||
- Atrybuty XML i struktury zagnieżdżone są w miarę możliwości zachowywane podczas konwersji w obie strony.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Konwertuje plik Markdown na dokument Word (DOCX)."
|
||||
i18n_source_hash: 979cb8ee13f2
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 3413daef846a
|
||||
---
|
||||
|
||||
# Markdown to Word {#markdown-to-word}
|
||||
|
||||
Konwertuje plik Markdown na dokument Word (DOCX), zachowując nagłówki, listy, bloki kodu i inne formatowanie.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-docx`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem Markdown.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Prześlij plik Markdown, a zostanie on przekonwertowany na DOCX.
|
||||
|
||||
## 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}
|
||||
|
||||
- Akceptowane formaty wejściowe: `.md`, `.markdown`.
|
||||
- To szybkie (synchroniczne) narzędzie, które zwraca wynik bezpośrednio.
|
||||
- Nagłówki, pogrubienie, kursywa, linki, bloki kodu i listy są mapowane na style Word.
|
||||
- Konwersję obsługuje Pandoc na serwerze.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Konwertuje plik Markdown na samodzielną stronę HTML."
|
||||
i18n_source_hash: 3ef805e8fc8c
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 8e2575f6b60b
|
||||
---
|
||||
|
||||
# Markdown to HTML {#markdown-to-html}
|
||||
|
||||
Konwertuje plik Markdown na samodzielną stronę HTML. Zdalne obrazy wskazywane w źródle pozostają w wyniku bez zmian.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-html`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem Markdown.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Prześlij plik Markdown, a zostanie on przekonwertowany na HTML.
|
||||
|
||||
## 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}
|
||||
|
||||
- Akceptowane formaty wejściowe: `.md`, `.markdown`.
|
||||
- To szybkie (synchroniczne) narzędzie, które zwraca wynik bezpośrednio.
|
||||
- Wynikiem jest samodzielna strona HTML ze stylami wpisanymi bezpośrednio.
|
||||
- Zdalne adresy URL obrazów w źródle Markdown są zachowywane bez zmian i nie są pobierane.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Konwertuj plik Markdown na stylizowany plik PDF."
|
||||
i18n_source_hash: 18474dc8772a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: c4c3776fb707
|
||||
---
|
||||
|
||||
# Markdown na PDF {#markdown-to-pdf}
|
||||
|
||||
Konwertuj plik Markdown na stylizowany dokument PDF. Zasoby zdalne są wyłączone ze względu na prywatność.
|
||||
|
||||
## Punkt końcowy API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-pdf`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem Markdown.
|
||||
|
||||
## Parametry {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Prześlij plik Markdown, a zostanie on przekonwertowany na PDF.
|
||||
|
||||
## Przykładowe żądanie {#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"
|
||||
```
|
||||
|
||||
## Przykładowa odpowiedź {#example-response}
|
||||
|
||||
Zwraca `202 Accepted`. Śledź postęp przez SSE pod `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Uwagi {#notes}
|
||||
|
||||
- Akceptowane formaty wejściowe: `.md`, `.markdown`.
|
||||
- Zasoby zdalne (obrazy, arkusze stylów odwołujące się przez adresy URL) nie są pobierane ze względu na prywatność i bezpieczeństwo.
|
||||
- Markdown jest najpierw renderowany do HTML, a następnie konwertowany na PDF za pomocą WeasyPrint.
|
||||
- Bloki kodu, tabele i inne elementy Markdown są stylizowane w wynikowym PDF.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Połącz wiele plików CSV lub TSV o pasujących kolumnach w jeden."
|
||||
i18n_source_hash: 109b5f399ac8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 6784e9ab2390
|
||||
---
|
||||
|
||||
# Scal pliki CSV {#merge-csvs}
|
||||
|
||||
Połącz wiele plików CSV lub TSV o pasujących kolumnach w jeden scalony plik. Wszystkie pliki wejściowe muszą mieć te same nagłówki kolumn.
|
||||
|
||||
## Punkt końcowy API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/merge-csvs`
|
||||
|
||||
Przyjmuje dane formularza multipart z dwoma lub więcej plikami CSV. Pole ustawień nie jest wymagane.
|
||||
|
||||
## Parametry {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Prześlij od 2 do 20 plików CSV lub TSV o pasujących nagłówkach kolumn.
|
||||
|
||||
## Przykładowe żądanie {#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"
|
||||
```
|
||||
|
||||
## Przykładowa odpowiedź {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.csv",
|
||||
"originalSize": 30000,
|
||||
"processedSize": 28500
|
||||
}
|
||||
```
|
||||
|
||||
## Uwagi {#notes}
|
||||
|
||||
- Wymaga od 2 do 20 plików wejściowych.
|
||||
- Wszystkie pliki muszą mieć te same nagłówki kolumn. Scalanie nie powiedzie się, jeśli kolumny nie będą się zgadzać.
|
||||
- Wiersz nagłówka jest dołączany raz do wyniku; wiersze danych ze wszystkich plików są łączone w kolejności przesyłania.
|
||||
- Akceptowane są zarówno pliki CSV, jak i TSV, ale wszystkie pliki w jednym żądaniu powinny używać tego samego separatora.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Konwertuj prezentacje na PDF."
|
||||
i18n_source_hash: 49bd71c46bed
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 9e801b2335f8
|
||||
---
|
||||
|
||||
# PowerPoint na PDF {#powerpoint-to-pdf}
|
||||
|
||||
Konwertuj prezentacje PowerPoint lub OpenDocument na PDF, jeden slajd na stronę.
|
||||
|
||||
## Punkt końcowy API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/powerpoint-to-pdf`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem PowerPoint/ODP.
|
||||
|
||||
## Parametry {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Prześlij prezentację, a zostanie ona przekonwertowana na PDF.
|
||||
|
||||
## Przykładowe żądanie {#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"
|
||||
```
|
||||
|
||||
## Przykładowa odpowiedź {#example-response}
|
||||
|
||||
Zwraca `202 Accepted`. Śledź postęp przez SSE pod `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Uwagi {#notes}
|
||||
|
||||
- Akceptowane formaty wejściowe: `.pptx`, `.ppt`, `.odp`.
|
||||
- Każdy slajd staje się jedną stroną w PDF.
|
||||
- Konwersję obsługuje LibreOffice działający w trybie headless na serwerze.
|
||||
- Animacje i przejścia nie są uwzględniane w wynikowym PDF.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Podziel plik CSV na mniejsze pliki według liczby wierszy."
|
||||
i18n_source_hash: a35dce4a99a3
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: ed96175fdcc4
|
||||
---
|
||||
|
||||
# Podziel CSV {#split-csv}
|
||||
|
||||
Podziel duży plik CSV lub TSV na mniejsze pliki według liczby wierszy. Zwraca archiwum ZIP zawierające części.
|
||||
|
||||
## Punkt końcowy API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/split-csv`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem CSV oraz polem JSON `settings`.
|
||||
|
||||
## Parametry {#parameters}
|
||||
|
||||
| Parametr | Typ | Wymagany | Domyślnie | Opis |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| rowsPerFile | integer | Nie | `1000` | Liczba wierszy danych na plik wynikowy (1-1 000 000) |
|
||||
| keepHeader | boolean | Nie | `true` | Powtórz wiersz nagłówka w każdym pliku wynikowym |
|
||||
|
||||
## Przykładowe żądanie {#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}'
|
||||
```
|
||||
|
||||
## Przykładowa odpowiedź {#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
|
||||
}
|
||||
```
|
||||
|
||||
## Uwagi {#notes}
|
||||
|
||||
- Wynik jest zawsze archiwum ZIP zawierającym podzielone części CSV, nazwane kolejno (np. `part-1.csv`, `part-2.csv`).
|
||||
- Gdy `keepHeader` ma wartość `true`, każda część zawiera oryginalny wiersz nagłówka, dzięki czemu każdy plik może być używany niezależnie.
|
||||
- Jako dane wejściowe akceptowane są zarówno pliki CSV, jak i TSV.
|
||||
- Liczba wierszy odnosi się wyłącznie do wierszy danych; wiersz nagłówka nie jest liczony.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Konwertuj pliki Word, Markdown, HTML lub zwykły tekst na EPUB."
|
||||
i18n_source_hash: 63e1afa91c52
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 9ab7f0e09af2
|
||||
---
|
||||
|
||||
# Konwertuj na EPUB {#convert-to-epub}
|
||||
|
||||
Konwertuj dokumenty Word, Markdown, HTML lub pliki zwykłego tekstu na format e-booka EPUB.
|
||||
|
||||
## Punkt końcowy API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/to-epub`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem Word/Markdown/HTML/TXT.
|
||||
|
||||
## Parametry {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Prześlij dokument, a zostanie on przekonwertowany na EPUB.
|
||||
|
||||
## Przykładowe żądanie {#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"
|
||||
```
|
||||
|
||||
## Przykładowa odpowiedź {#example-response}
|
||||
|
||||
Zwraca `202 Accepted`. Śledź postęp przez SSE pod `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Uwagi {#notes}
|
||||
|
||||
- Akceptowane formaty wejściowe: `.docx`, `.md`, `.html`, `.txt`.
|
||||
- Wynik EPUB jest zgodny ze specyfikacją EPUB 3.
|
||||
- Nagłówki w dokumencie źródłowym służą do wygenerowania spisu treści.
|
||||
- Konwersję obsługuje Pandoc na serwerze.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Konwertuj dokumenty Word na PDF."
|
||||
i18n_source_hash: f814ba1a1a53
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 8a33d52287c9
|
||||
---
|
||||
|
||||
# Word na PDF {#word-to-pdf}
|
||||
|
||||
Konwertuj dokumenty Word, tekst OpenDocument, RTF lub pliki zwykłego tekstu na PDF.
|
||||
|
||||
## Punkt końcowy API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/word-to-pdf`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem Word/ODT/RTF/TXT.
|
||||
|
||||
## Parametry {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Prześlij dokument, a zostanie on przekonwertowany na PDF.
|
||||
|
||||
## Przykładowe żądanie {#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"
|
||||
```
|
||||
|
||||
## Przykładowa odpowiedź {#example-response}
|
||||
|
||||
Zwraca `202 Accepted`. Śledź postęp przez SSE pod `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Uwagi {#notes}
|
||||
|
||||
- Akceptowane formaty wejściowe: `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- Konwersję obsługuje LibreOffice działający w trybie headless na serwerze.
|
||||
- Czcionki osadzone w dokumencie są używane, gdy są dostępne; w przeciwnym razie zastępowane są czcionkami systemowymi.
|
||||
- Nagłówki, stopki, tabele i obrazy są zachowywane w wynikowym PDF.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Wyodrębnij powtarzające się elementy z XML do tabeli CSV."
|
||||
i18n_source_hash: 3ab1019bff8a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: ce37ba0078e2
|
||||
---
|
||||
|
||||
# XML na CSV {#xml-to-csv}
|
||||
|
||||
Wyodrębnij powtarzające się elementy z pliku XML do płaskiej tabeli CSV. Narzędzie automatycznie znajduje pierwszą tablicę obiektów w drzewie XML i mapuje każdy element na wiersz.
|
||||
|
||||
## Punkt końcowy API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/xml-to-csv`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem XML. Pole ustawień nie jest wymagane.
|
||||
|
||||
## Parametry {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Powtarzający się element jest wykrywany automatycznie na podstawie struktury XML.
|
||||
|
||||
## Przykładowe żądanie {#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"
|
||||
```
|
||||
|
||||
## Przykładowa odpowiedź {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/catalog.csv",
|
||||
"originalSize": 4500,
|
||||
"processedSize": 1800
|
||||
}
|
||||
```
|
||||
|
||||
## Uwagi {#notes}
|
||||
|
||||
- Jako dane wejściowe akceptowane są wyłącznie pliki `.xml`.
|
||||
- Narzędzie skanuje drzewo XML w poszukiwaniu pierwszego powtarzającego się zestawu elementów rodzeństwa i używa ich jako wierszy.
|
||||
- Każda unikalna nazwa elementu podrzędnego lub atrybutu staje się nagłówkiem kolumny CSV.
|
||||
- To konwersja jednokierunkowa. Do dwukierunkowej konwersji JSON/XML użyj narzędzia [JSON na XML](/pl/tools/files/json-xml).
|
||||
@@ -0,0 +1,55 @@
|
||||
---
|
||||
description: "Konwertuj między YAML a JSON w obu kierunkach."
|
||||
i18n_source_hash: acf8ca21ee99
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: d0d88d845f4d
|
||||
---
|
||||
|
||||
# YAML / JSON {#yaml-json}
|
||||
|
||||
Konwertuj między formatami YAML i JSON w obu kierunkach. Prześlij plik YAML, aby otrzymać JSON, lub prześlij plik JSON, aby otrzymać YAML.
|
||||
|
||||
## Punkt końcowy API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/yaml-json`
|
||||
|
||||
Przyjmuje dane formularza multipart z plikiem YAML lub JSON. Pole ustawień nie jest wymagane.
|
||||
|
||||
## Parametry {#parameters}
|
||||
|
||||
To narzędzie nie ma konfigurowalnych parametrów. Kierunek konwersji jest określany na podstawie rozszerzenia pliku wejściowego.
|
||||
|
||||
## Przykładowe żądanie {#example-request}
|
||||
|
||||
YAML na 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 na 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"
|
||||
```
|
||||
|
||||
## Przykładowa odpowiedź {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.json",
|
||||
"originalSize": 620,
|
||||
"processedSize": 780
|
||||
}
|
||||
```
|
||||
|
||||
## Uwagi {#notes}
|
||||
|
||||
- Kierunek konwersji jest wykrywany automatycznie na podstawie rozszerzenia pliku wejściowego: `.yaml` lub `.yml` daje `.json`, a `.json` daje `.yaml`.
|
||||
- Akceptowane są zarówno rozszerzenia `.yaml`, jak i `.yml`.
|
||||
- Konwertowany jest tylko pierwszy dokument w wielodokumentowym pliku YAML; dodatkowe dokumenty oddzielone przez `---` są ignorowane.
|
||||
Reference in New Issue
Block a user