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: "Crea grafici a barre, a linee o a torta da dati CSV o JSON."
|
||||
i18n_source_hash: d3c39384457b
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: f2f921e4fb62
|
||||
---
|
||||
|
||||
# Chart Maker {#chart-maker}
|
||||
|
||||
Crea grafici a barre, a linee o a torta da dati CSV o JSON. Restituisce un'immagine PNG del grafico renderizzato.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/chart-maker`
|
||||
|
||||
Accetta dati form multipart con un file CSV o JSON e un campo JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| kind | string | No | `"bar"` | Tipo di grafico: `bar`, `line`, `pie` |
|
||||
| title | string | No | - | Titolo del grafico (massimo 120 caratteri) |
|
||||
| width | integer | No | `960` | Larghezza del grafico in pixel (320-2048) |
|
||||
| height | integer | No | `540` | Altezza del grafico in pixel (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}
|
||||
|
||||
- L'input deve essere un file `.csv` o `.json`. I file CSV dovrebbero avere una riga di intestazione con i nomi delle colonne.
|
||||
- La prima colonna viene usata come etichetta di categoria; la seconda colonna deve essere numerica e fornisce i valori dei dati. Vengono usate solo due colonne.
|
||||
- L'input JSON dovrebbe essere un array di oggetti `{label, value}`, oppure un oggetto semplice le cui chiavi diventano etichette e i cui valori diventano punti dati.
|
||||
- Massimo 100 punti dati. Tutti i valori devono essere maggiori o uguali a zero.
|
||||
- L'output è sempre un'immagine PNG indipendentemente dal formato di input.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Converte tra i formati Word, OpenDocument, RTF e testo semplice."
|
||||
i18n_source_hash: 89771292569d
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 3e9b4313b9d8
|
||||
---
|
||||
|
||||
# Convert Document {#convert-document}
|
||||
|
||||
Converte i documenti tra i formati Word (DOCX), OpenDocument (ODT), RTF e testo semplice usando LibreOffice.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-document`
|
||||
|
||||
Accetta dati form multipart con un file Word/ODT/RTF/TXT e un campo JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Yes | - | Formato di output: `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}
|
||||
|
||||
Restituisce `202 Accepted`. Monitora l'avanzamento tramite SSE su `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Formati di input accettati: `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- La conversione è gestita da LibreOffice in esecuzione headless sul server.
|
||||
- La formattazione complessa (macro, oggetti incorporati) potrebbe non sopravvivere alla conversione tra i formati.
|
||||
- Il formato di output deve essere diverso dal formato di input.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Converte tra i formati di presentazione PowerPoint e OpenDocument."
|
||||
i18n_source_hash: 08ba415d39ac
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 8e16f2290e49
|
||||
---
|
||||
|
||||
# Convert Presentation {#convert-presentation}
|
||||
|
||||
Converte le presentazioni tra i formati PowerPoint (PPTX) e OpenDocument Presentation (ODP).
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-presentation`
|
||||
|
||||
Accetta dati form multipart con un file PowerPoint/ODP e un campo JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Yes | - | Formato di output: `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}
|
||||
|
||||
Restituisce `202 Accepted`. Monitora l'avanzamento tramite SSE su `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Formati di input accettati: `.pptx`, `.ppt`, `.odp`.
|
||||
- La conversione è gestita da LibreOffice in esecuzione headless sul server.
|
||||
- Le animazioni e gli effetti di transizione potrebbero non essere preservati tra i formati.
|
||||
- Il formato di output deve essere diverso dal formato di input.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Converte tra i formati Excel, OpenDocument e CSV."
|
||||
i18n_source_hash: b813b1b06962
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 7b99ca90cd84
|
||||
---
|
||||
|
||||
# Convert Spreadsheet {#convert-spreadsheet}
|
||||
|
||||
Converte i fogli di calcolo tra i formati Excel (XLSX), OpenDocument Spreadsheet (ODS) e CSV. Le cartelle di lavoro multi-foglio esportano il primo foglio quando si converte in CSV.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/convert-spreadsheet`
|
||||
|
||||
Accetta dati form multipart con un file Excel/ODS/CSV e un campo JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Yes | - | Formato di output: `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}
|
||||
|
||||
Restituisce `202 Accepted`. Monitora l'avanzamento tramite SSE su `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Formati di input accettati: `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- Quando si converte una cartella di lavoro multi-foglio in CSV, viene esportato solo il primo foglio.
|
||||
- Le formule vengono valutate ed esportate come valori statici nell'output CSV.
|
||||
- Il formato di output deve essere diverso dal formato di input.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Raggruppa più file in un unico archivio ZIP."
|
||||
i18n_source_hash: 9ff1250dbd36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: a3edb0237cf3
|
||||
---
|
||||
|
||||
# Create ZIP {#create-zip}
|
||||
|
||||
Raggruppa più file di qualsiasi tipo in un unico archivio ZIP. I nomi di file duplicati vengono deduplicati automaticamente.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/create-zip`
|
||||
|
||||
Accetta dati form multipart con due o più file. Non è richiesto alcun campo settings.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. Carica da 2 a 50 file di qualsiasi tipo da raggruppare.
|
||||
|
||||
## 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}
|
||||
|
||||
- Richiede tra 2 e 50 file di input.
|
||||
- È accettato qualsiasi tipo di file; non ci sono restrizioni sul formato di input.
|
||||
- Se più file condividono lo stesso nome, vengono deduplicati automaticamente con suffissi numerici.
|
||||
- L'archivio di output usa la compressione ZIP standard (deflate).
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "Converte tra CSV ed Excel (XLSX), in entrambe le direzioni."
|
||||
i18n_source_hash: 213297311e36
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 70059ad4858f
|
||||
---
|
||||
|
||||
# CSV to Excel {#csv-to-excel}
|
||||
|
||||
Converte tra i formati CSV ed Excel (XLSX) in entrambe le direzioni. Carica un file CSV o TSV per ottenere XLSX, oppure carica un file XLSX per ottenere CSV.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-excel`
|
||||
|
||||
Accetta dati form multipart con un file CSV, TSV o XLSX e un campo JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| sheet | integer | No | `1` | Numero del foglio di lavoro da esportare quando si converte da XLSX (min 1) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
CSV to 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 to 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}
|
||||
|
||||
- La direzione della conversione viene rilevata automaticamente dall'estensione del file di input: `.csv` o `.tsv` produce `.xlsx`, e `.xlsx` produce `.csv`.
|
||||
- Il parametro `sheet` si applica solo quando si converte da XLSX. Seleziona quale foglio di lavoro esportare.
|
||||
- I file TSV (valori separati da tabulazioni) sono supportati insieme a CSV.
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
description: "Converte tra CSV e JSON, in entrambe le direzioni."
|
||||
i18n_source_hash: 978c08ad46d3
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: f7113d2bf1c6
|
||||
---
|
||||
|
||||
# CSV to JSON {#csv-to-json}
|
||||
|
||||
Converte tra i formati CSV e JSON in entrambe le direzioni. Carica un file CSV o TSV per ottenere un array JSON di oggetti, oppure carica un array JSON per ottenere un file CSV.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/csv-json`
|
||||
|
||||
Accetta dati form multipart con un file CSV, TSV o JSON e un campo JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | No | `true` | Formatta l'output JSON con indentazione |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
CSV to 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 to 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}
|
||||
|
||||
- La direzione della conversione viene rilevata automaticamente dall'estensione del file di input: `.csv` o `.tsv` produce `.json`, e `.json` produce `.csv`.
|
||||
- Il parametro `pretty` influisce solo sull'output JSON. Quando impostato su `false`, l'output è una stringa JSON compatta su una sola riga.
|
||||
- L'input JSON deve essere un array di oggetti con chiavi coerenti. Ogni oggetto diventa una riga e ogni chiave diventa un'intestazione di colonna.
|
||||
- I file TSV (valori separati da tabulazioni) sono supportati insieme a CSV.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Converte un EPUB in PDF, DOCX, HTML o Markdown."
|
||||
i18n_source_hash: 7d94fc18ca97
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: bc94d0ccdea1
|
||||
---
|
||||
|
||||
# Convert EPUB {#convert-epub}
|
||||
|
||||
Converte un e-book EPUB in PDF, Word (DOCX), HTML o Markdown. Le risorse remote all'interno del libro non vengono recuperate.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/epub-convert`
|
||||
|
||||
Accetta dati form multipart con un file EPUB e un campo JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Yes | - | Formato di output: `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}
|
||||
|
||||
Restituisce `202 Accepted`. Monitora l'avanzamento tramite SSE su `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Formato di input accettato: `.epub`.
|
||||
- Le risorse remote incorporate nell'EPUB (immagini e font esterni) non vengono recuperate per motivi di sicurezza.
|
||||
- La fedeltà delle immagini nell'output convertito può variare a seconda della struttura dell'EPUB.
|
||||
- La conversione è gestita da Pandoc sul server.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converte i fogli di calcolo in PDF."
|
||||
i18n_source_hash: 4dbe2a810ea6
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 3e8941a1600e
|
||||
---
|
||||
|
||||
# Excel to PDF {#excel-to-pdf}
|
||||
|
||||
Converte i fogli di calcolo Excel, OpenDocument o CSV in PDF. I fogli larghi possono essere impaginati su più pagine.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/excel-to-pdf`
|
||||
|
||||
Accetta dati form multipart con un file Excel/ODS/CSV.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. Carica un foglio di calcolo e verrà convertito in 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}
|
||||
|
||||
Restituisce `202 Accepted`. Monitora l'avanzamento tramite SSE su `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Formati di input accettati: `.xlsx`, `.xls`, `.ods`, `.csv`.
|
||||
- I fogli larghi possono essere suddivisi su più pagine nel PDF risultante.
|
||||
- I grafici e la formattazione condizionale vengono renderizzati nell'output PDF.
|
||||
- La conversione è gestita da LibreOffice in esecuzione headless sul server.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Estrae in sicurezza i file da un archivio ZIP con protezione dalle bomb."
|
||||
i18n_source_hash: 484a1f1051b8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 57ab1d28803f
|
||||
---
|
||||
|
||||
# Extract ZIP {#extract-zip}
|
||||
|
||||
Estrae in sicurezza i file da un archivio ZIP. Gli archivi con un solo file restituiscono direttamente il file contenuto; gli archivi con più file restituiscono uno ZIP piatto con i contenuti estratti.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/extract-zip`
|
||||
|
||||
Accetta dati form multipart con un file ZIP. Non è richiesto alcun campo settings.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. Carica un file `.zip` da estrarre.
|
||||
|
||||
## 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}
|
||||
|
||||
- Come input sono accettati solo file `.zip`.
|
||||
- Se l'archivio contiene un solo file, quel file viene restituito direttamente (non racchiuso in uno ZIP).
|
||||
- Se l'archivio contiene più file, viene restituito uno ZIP piatto con tutti i file estratti al livello radice (la struttura delle directory annidate viene appiattita).
|
||||
- La protezione integrata dalle bomb rifiuta gli archivi con rapporti di compressione o conteggi di file eccessivi per prevenire l'esaurimento delle risorse.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converte un file HTML in PDF."
|
||||
i18n_source_hash: 20b9ae147db5
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: b450c442bf2f
|
||||
---
|
||||
|
||||
# HTML to PDF {#html-to-pdf}
|
||||
|
||||
Converte un file HTML in un documento PDF con stile. Le risorse remote (immagini, fogli di stile e script esterni) sono disabilitate per privacy.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/html-to-pdf`
|
||||
|
||||
Accetta dati form multipart con un file HTML.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. Carica un file HTML e verrà convertito in 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}
|
||||
|
||||
Restituisce `202 Accepted`. Monitora l'avanzamento tramite SSE su `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Formati di input accettati: `.html`, `.htm`.
|
||||
- Le risorse remote (immagini, fogli di stile e script referenziati tramite URL) non vengono recuperate per privacy e sicurezza.
|
||||
- Gli stili inline e le immagini incorporate (data URI) vengono preservati.
|
||||
- La conversione è gestita da WeasyPrint sul server.
|
||||
@@ -0,0 +1,59 @@
|
||||
---
|
||||
description: "Converte tra JSON e XML, in entrambe le direzioni."
|
||||
i18n_source_hash: b3a6ded0c64a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 96a157ce85e6
|
||||
---
|
||||
|
||||
# JSON to XML {#json-to-xml}
|
||||
|
||||
Converte tra i formati JSON e XML in entrambe le direzioni. Carica un file JSON per ottenere XML, oppure carica un file XML per ottenere JSON.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/json-xml`
|
||||
|
||||
Accetta dati form multipart con un file JSON o XML e un campo JSON `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| pretty | boolean | No | `true` | Formatta l'output con indentazione |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
JSON to 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 to 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}
|
||||
|
||||
- La direzione della conversione viene rilevata automaticamente dall'estensione del file di input: `.json` produce `.xml`, e `.xml` produce `.json`.
|
||||
- Il parametro `pretty` si applica a entrambe le direzioni. Quando `false`, l'output è compatto senza indentazione.
|
||||
- Gli attributi XML e le strutture annidate vengono preservati durante la conversione di andata e ritorno dove possibile.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converte un file Markdown in un documento Word (DOCX)."
|
||||
i18n_source_hash: 979cb8ee13f2
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 5e30fda13b5e
|
||||
---
|
||||
|
||||
# Markdown to Word {#markdown-to-word}
|
||||
|
||||
Converte un file Markdown in un documento Word (DOCX), preservando intestazioni, elenchi, blocchi di codice e altra formattazione.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-docx`
|
||||
|
||||
Accetta dati form multipart con un file Markdown.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. Carica un file Markdown e verrà convertito in 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}
|
||||
|
||||
- Formati di input accettati: `.md`, `.markdown`.
|
||||
- Questo è uno strumento veloce (sincrono) che restituisce direttamente il risultato.
|
||||
- Intestazioni, grassetto, corsivo, link, blocchi di codice ed elenchi vengono mappati agli stili di Word.
|
||||
- La conversione è gestita da Pandoc sul server.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converte un file Markdown in una pagina HTML autonoma."
|
||||
i18n_source_hash: 3ef805e8fc8c
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: a71d66aa0251
|
||||
---
|
||||
|
||||
# Markdown to HTML {#markdown-to-html}
|
||||
|
||||
Converte un file Markdown in una pagina HTML autonoma. Le immagini remote referenziate nella sorgente vengono lasciate invariate nell'output.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-html`
|
||||
|
||||
Accetta dati form multipart con un file Markdown.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. Carica un file Markdown e verrà convertito in 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}
|
||||
|
||||
- Formati di input accettati: `.md`, `.markdown`.
|
||||
- Questo è uno strumento veloce (sincrono) che restituisce direttamente il risultato.
|
||||
- L'output è una pagina HTML autonoma con stili inline.
|
||||
- Gli URL delle immagini remote nella sorgente Markdown vengono preservati invariati e non recuperati.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converte un file Markdown in un PDF con stile applicato."
|
||||
i18n_source_hash: 18474dc8772a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 42e8f4ba7047
|
||||
---
|
||||
|
||||
# Da Markdown a PDF {#markdown-to-pdf}
|
||||
|
||||
Converte un file Markdown in un documento PDF con stile applicato. Le risorse remote sono disabilitate per motivi di privacy.
|
||||
|
||||
## Endpoint API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/markdown-to-pdf`
|
||||
|
||||
Accetta dati di form multipart con un file Markdown.
|
||||
|
||||
## Parametri {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. Carica un file Markdown e verrà convertito in PDF.
|
||||
|
||||
## Esempio di richiesta {#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"
|
||||
```
|
||||
|
||||
## Esempio di risposta {#example-response}
|
||||
|
||||
Restituisce `202 Accepted`. Monitora l'avanzamento tramite SSE su `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Note {#notes}
|
||||
|
||||
- Formati di input accettati: `.md`, `.markdown`.
|
||||
- Le risorse remote (immagini, fogli di stile referenziati tramite URL) non vengono scaricate per motivi di privacy e sicurezza.
|
||||
- Il Markdown viene prima renderizzato in HTML, poi convertito in PDF tramite WeasyPrint.
|
||||
- Blocchi di codice, tabelle e altri elementi Markdown vengono formattati nell'output PDF.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Combina più file CSV o TSV con colonne corrispondenti in un unico file."
|
||||
i18n_source_hash: 109b5f399ac8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 09972600d643
|
||||
---
|
||||
|
||||
# Unisci CSV {#merge-csvs}
|
||||
|
||||
Combina più file CSV o TSV con colonne corrispondenti in un unico file unito. Tutti i file di input devono avere le stesse intestazioni di colonna.
|
||||
|
||||
## Endpoint API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/merge-csvs`
|
||||
|
||||
Accetta dati di form multipart con due o più file CSV. Non è richiesto alcun campo di impostazioni.
|
||||
|
||||
## Parametri {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. Carica da 2 a 20 file CSV o TSV con intestazioni di colonna corrispondenti.
|
||||
|
||||
## Esempio di richiesta {#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"
|
||||
```
|
||||
|
||||
## Esempio di risposta {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.csv",
|
||||
"originalSize": 30000,
|
||||
"processedSize": 28500
|
||||
}
|
||||
```
|
||||
|
||||
## Note {#notes}
|
||||
|
||||
- Richiede tra 2 e 20 file di input.
|
||||
- Tutti i file devono condividere le stesse intestazioni di colonna. L'unione fallisce se le colonne non corrispondono.
|
||||
- La riga di intestazione è inclusa una sola volta nell'output; le righe di dati di tutti i file vengono concatenate nell'ordine di caricamento.
|
||||
- Sono accettati sia file CSV che TSV, ma tutti i file di una singola richiesta dovrebbero usare lo stesso delimitatore.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converte le presentazioni in PDF."
|
||||
i18n_source_hash: 49bd71c46bed
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 5f5739b8c5ec
|
||||
---
|
||||
|
||||
# Da PowerPoint a PDF {#powerpoint-to-pdf}
|
||||
|
||||
Converte presentazioni PowerPoint o OpenDocument in PDF, con una diapositiva per pagina.
|
||||
|
||||
## Endpoint API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/powerpoint-to-pdf`
|
||||
|
||||
Accetta dati di form multipart con un file PowerPoint/ODP.
|
||||
|
||||
## Parametri {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. Carica una presentazione e verrà convertita in PDF.
|
||||
|
||||
## Esempio di richiesta {#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"
|
||||
```
|
||||
|
||||
## Esempio di risposta {#example-response}
|
||||
|
||||
Restituisce `202 Accepted`. Monitora l'avanzamento tramite SSE su `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Note {#notes}
|
||||
|
||||
- Formati di input accettati: `.pptx`, `.ppt`, `.odp`.
|
||||
- Ogni diapositiva diventa una pagina nel PDF.
|
||||
- La conversione è gestita da LibreOffice in esecuzione headless sul server.
|
||||
- Animazioni e transizioni non sono incluse nell'output PDF.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Divide un CSV in file più piccoli in base al numero di righe."
|
||||
i18n_source_hash: a35dce4a99a3
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: e6add1c01c9b
|
||||
---
|
||||
|
||||
# Dividi CSV {#split-csv}
|
||||
|
||||
Divide un file CSV o TSV di grandi dimensioni in file più piccoli in base al numero di righe. Restituisce un archivio ZIP contenente le parti.
|
||||
|
||||
## Endpoint API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/split-csv`
|
||||
|
||||
Accetta dati di form multipart con un file CSV e un campo JSON `settings`.
|
||||
|
||||
## Parametri {#parameters}
|
||||
|
||||
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| rowsPerFile | integer | No | `1000` | Numero di righe di dati per file di output (1-1.000.000) |
|
||||
| keepHeader | boolean | No | `true` | Ripete la riga di intestazione in ogni file di output |
|
||||
|
||||
## Esempio di richiesta {#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}'
|
||||
```
|
||||
|
||||
## Esempio di risposta {#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
|
||||
}
|
||||
```
|
||||
|
||||
## Note {#notes}
|
||||
|
||||
- L'output è sempre un archivio ZIP contenente le parti CSV divise, denominate in sequenza (ad es. `part-1.csv`, `part-2.csv`).
|
||||
- Quando `keepHeader` è `true`, ogni parte include la riga di intestazione originale così che ogni file possa essere usato in modo indipendente.
|
||||
- Sono accettati come input sia file CSV che TSV.
|
||||
- Il conteggio delle righe si riferisce solo alle righe di dati; la riga di intestazione non viene conteggiata.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converte file Word, Markdown, HTML o testo semplice in EPUB."
|
||||
i18n_source_hash: 63e1afa91c52
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 38422d4492ff
|
||||
---
|
||||
|
||||
# Converti in EPUB {#convert-to-epub}
|
||||
|
||||
Converte documenti Word, Markdown, HTML o file di testo semplice nel formato e-book EPUB.
|
||||
|
||||
## Endpoint API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/to-epub`
|
||||
|
||||
Accetta dati di form multipart con un file Word/Markdown/HTML/TXT.
|
||||
|
||||
## Parametri {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. Carica un documento e verrà convertito in EPUB.
|
||||
|
||||
## Esempio di richiesta {#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"
|
||||
```
|
||||
|
||||
## Esempio di risposta {#example-response}
|
||||
|
||||
Restituisce `202 Accepted`. Monitora l'avanzamento tramite SSE su `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Note {#notes}
|
||||
|
||||
- Formati di input accettati: `.docx`, `.md`, `.html`, `.txt`.
|
||||
- L'output EPUB segue la specifica EPUB 3.
|
||||
- Le intestazioni del documento di origine vengono usate per generare l'indice.
|
||||
- La conversione è gestita da Pandoc sul server.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Converte documenti Word in PDF."
|
||||
i18n_source_hash: f814ba1a1a53
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 3c609fdeac12
|
||||
---
|
||||
|
||||
# Da Word a PDF {#word-to-pdf}
|
||||
|
||||
Converte documenti Word, testo OpenDocument, RTF o file di testo semplice in PDF.
|
||||
|
||||
## Endpoint API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/word-to-pdf`
|
||||
|
||||
Accetta dati di form multipart con un file Word/ODT/RTF/TXT.
|
||||
|
||||
## Parametri {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. Carica un documento e verrà convertito in PDF.
|
||||
|
||||
## Esempio di richiesta {#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"
|
||||
```
|
||||
|
||||
## Esempio di risposta {#example-response}
|
||||
|
||||
Restituisce `202 Accepted`. Monitora l'avanzamento tramite SSE su `/api/v1/jobs/{jobId}/progress`.
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
## Note {#notes}
|
||||
|
||||
- Formati di input accettati: `.docx`, `.doc`, `.odt`, `.rtf`, `.txt`.
|
||||
- La conversione è gestita da LibreOffice in esecuzione headless sul server.
|
||||
- I font incorporati nel documento vengono usati quando disponibili; altrimenti vengono sostituiti con i font di sistema.
|
||||
- Intestazioni, piè di pagina, tabelle e immagini sono mantenuti nell'output PDF.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Estrae elementi ripetuti da un XML in una tabella CSV."
|
||||
i18n_source_hash: 3ab1019bff8a
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 502b4980705a
|
||||
---
|
||||
|
||||
# Da XML a CSV {#xml-to-csv}
|
||||
|
||||
Estrae elementi ripetuti da un file XML in una tabella CSV piatta. Lo strumento trova automaticamente il primo array di oggetti nell'albero XML e mappa ogni elemento a una riga.
|
||||
|
||||
## Endpoint API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/xml-to-csv`
|
||||
|
||||
Accetta dati di form multipart con un file XML. Non è richiesto alcun campo di impostazioni.
|
||||
|
||||
## Parametri {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. L'elemento ripetuto viene rilevato automaticamente dalla struttura XML.
|
||||
|
||||
## Esempio di richiesta {#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"
|
||||
```
|
||||
|
||||
## Esempio di risposta {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/catalog.csv",
|
||||
"originalSize": 4500,
|
||||
"processedSize": 1800
|
||||
}
|
||||
```
|
||||
|
||||
## Note {#notes}
|
||||
|
||||
- Sono accettati come input solo file `.xml`.
|
||||
- Lo strumento analizza l'albero XML alla ricerca del primo insieme ripetuto di elementi fratelli e li usa come righe.
|
||||
- Ogni nome univoco di elemento figlio o attributo diventa un'intestazione di colonna CSV.
|
||||
- Questa è una conversione a senso unico. Per la conversione bidirezionale JSON/XML, usa lo strumento [Da JSON a XML](/it/tools/files/json-xml).
|
||||
@@ -0,0 +1,55 @@
|
||||
---
|
||||
description: "Converte tra YAML e JSON, in entrambe le direzioni."
|
||||
i18n_source_hash: acf8ca21ee99
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 88a1fe592187
|
||||
---
|
||||
|
||||
# YAML / JSON {#yaml-json}
|
||||
|
||||
Converte tra i formati YAML e JSON in entrambe le direzioni. Carica un file YAML per ottenere JSON, oppure carica un file JSON per ottenere YAML.
|
||||
|
||||
## Endpoint API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/files/yaml-json`
|
||||
|
||||
Accetta dati di form multipart con un file YAML o JSON. Non è richiesto alcun campo di impostazioni.
|
||||
|
||||
## Parametri {#parameters}
|
||||
|
||||
Questo strumento non ha parametri configurabili. La direzione della conversione è determinata dall'estensione del file di input.
|
||||
|
||||
## Esempio di richiesta {#example-request}
|
||||
|
||||
Da YAML a 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"
|
||||
```
|
||||
|
||||
Da JSON a 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"
|
||||
```
|
||||
|
||||
## Esempio di risposta {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/config.json",
|
||||
"originalSize": 620,
|
||||
"processedSize": 780
|
||||
}
|
||||
```
|
||||
|
||||
## Note {#notes}
|
||||
|
||||
- La direzione della conversione viene rilevata automaticamente dall'estensione del file di input: `.yaml` o `.yml` produce `.json`, e `.json` produce `.yaml`.
|
||||
- Sono accettate entrambe le estensioni `.yaml` e `.yml`.
|
||||
- Viene convertito solo il primo documento in un file YAML multi-documento; i documenti aggiuntivi separati da `---` vengono ignorati.
|
||||
Reference in New Issue
Block a user