--- seo_title: API Conversione File: Tutti gli Endpoint Convert | EnConvert meta_desc: L'API di conversione EnConvert: 51 endpoint per pagine web, documenti, formati dati e immagini, con un'unica forma di richiesta e una risposta con URL firmato. keywords: api conversione file, endpoint api convert, post v1 convert, api url in pdf, api documento in pdf, api conversione immagini, api conversione formati dati, matrice di conversione, upload file multipart conversione --- # Endpoint di Conversione File Convert è la metà deterministica di EnConvert: 51 endpoint che prendono un file o un URL e restituiscono lo stesso contenuto in un altro formato. Ognuno è un `POST` verso `/v1/convert/`, quindi una volta che ne hai chiamato uno sai come chiamare tutti gli altri. ## Un'unica forma di richiesta Tra una conversione e l'altra cambiano tre cose: l'id nel percorso, cosa invii e cos'è il risultato. Nient'altro si muove. **Percorso.** `POST https://api.enconvert.com/v1/convert/`, dove `` indica la coppia di conversione: `url-to-pdf`, `doc-to-pdf`, `csv-to-json`, `heic-to-webp`. **Input.** Un file oppure un URL. - Le conversioni di file, 46 delle 51, accettano `multipart/form-data` con il file nel campo `file`. - Le conversioni di pagine web, le altre cinque, accettano `application/json` con un campo `url` che accetta un singolo URL o un array di URL. **Output.** Ogni conversione scrive il risultato su object storage e risponde con un URL di download firmato valido per 15 minuti. Gli endpoint che supportano `direct_download` possono invece restituire i byte in streaming nel corpo della risposta; ogni pagina di famiglia indica il proprio valore predefinito. Consulta [URL firmati](/it/docs/concepts/signed-urls.md). ## Esempio Invia un URL, ottieni un PDF: ```bash curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf \ -H "X-API-Key: sk_your_private_key" \ -H "Content-Type: application/json" \ -d '{"url": "https://example.com"}' ``` ```json { "presigned_url": "https://spaces.example.com/...signed...", "object_key": "live/files/4127/url-to-pdf/example_20260405_123456789.pdf", "filename": "example_20260405_123456789.pdf", "file_size": 48213, "conversion_time_seconds": 2.41 } ``` La stessa chiamata in forma di upload, per i 46 endpoint di file: ```bash curl -X POST https://api.enconvert.com/v1/convert/doc-to-pdf \ -H "X-API-Key: sk_your_private_key" \ -F "file=@quarterly-report.docx" ``` ## Scegli una famiglia | Pagina | Endpoint | Cosa copre | |------|-----------|----------------| | [Matrice di Conversione](/it/docs/endpoints/convert/matrix.md) | tutti e 51 | Ogni formato di input e ogni formato di output in un'unica tabella, con l'id dell'endpoint per ciascuna coppia. Parti da qui quando sai cosa hai e cosa vuoi. | | [Pagine Web](/it/docs/endpoints/convert/web-pages.md) | 5 | Renderizza un URL live in PDF, in un PNG a pagina intera o in Markdown, oppure scansiona un intero sito e ricevi un unico ZIP. | | [Documenti](/it/docs/endpoints/convert/documents.md) | 13 | Word, Excel, PowerPoint, Pages, Numbers, OpenDocument, HTML e Markdown in PDF, più `anything-to-pdf` (36 estensioni di input) e `anything-to-markdown` (22). | | [Formati Dati](/it/docs/endpoints/convert/data-formats.md) | 11 | JSON, XML, YAML, CSV e TOML in entrambe le direzioni, più Markdown in HTML. | | [Immagini](/it/docs/endpoints/convert/images.md) | 22 | JPEG, PNG, SVG, HEIC e WebP tra loro, pagine PDF renderizzate in JPEG e compressione nello stesso formato. | Ogni pagina di famiglia elenca i suoi endpoint in una tabella con il percorso esatto di ciascuno. Poi ogni endpoint ha la sua pagina: parametri della richiesta, risposta, casi di errore che può restituire ed esempi di codice.
Gli endpoint Office ignorano la geometria di pagina. I nove endpoint basati su LibreOffice (doc-to-pdf, excel-to-pdf, ppt-to-pdf, odt-to-pdf, ods-to-pdf, odp-to-pdf, ots-to-pdf, pages-to-pdf, numbers-to-pdf) accettano pdf_options ma rispettano solo grayscale. Dimensione della pagina, orientamento e margini vengono presi dal documento sorgente, quindi impostarne uno esplicitamente restituisce 400.
## Cosa hanno in comune tutti gli endpoint convert - **Credenziali e content type** sono gli stessi su tutta l'API. Consulta [Endpoint](/it/docs/endpoints.md). - **Async e batch** sono disponibili solo sui cinque endpoint delle pagine web. Gli upload di file vengono sempre eseguiti in modo sincrono, un file per richiesta. Consulta [Job sincroni e asincroni](/it/docs/concepts/sync-and-async.md) e [Elaborazione batch](/it/docs/guides/batch-processing.md). - **La dimensione di upload** è limitata per piano, a partire da 5 MB sul piano Founding. Oltre il tetto ricevi `413` con la dimensione del tuo file e il limite massimo nel corpo della risposta. Consulta [Rate limit e quote](/it/docs/reference/rate-limits.md). - **Il costo** è di una op per conversione. Un batch di 10 URL sono 10 ops, e l'intero batch viene verificato rispetto alla quota rimanente prima che venga renderizzata qualsiasi pagina. - **I timeout** sono reali. Le conversioni LibreOffice vengono interrotte a 120 secondi e restituiscono `504`; il gateway stesso abbandona qualsiasi richiesta dopo 300 secondi. - **Gli errori** usano gli stessi codici di stato in tutte le famiglie: `400` per input non valido, `401` per credenziali errate, `402` per la quota, `403` per una funzionalità limitata dal piano, `413` per un upload troppo grande. Consulta [Codici di errore](/it/docs/reference/errors.md). ## Domande frequenti ### Quali endpoint accettano un URL invece di un file? I cinque endpoint delle pagine web: `url-to-pdf`, `url-to-screenshot`, `url-to-markdown`, `website-to-pdf` e `website-to-screenshot`. Gli altri 46 accettano solo upload, `anything-to-pdf` incluso. Per convertire un documento che si trova a un URL, scaricalo tu e carica i byte. ### Posso convertire più file in un'unica richiesta? Non come upload. Il batch funziona sugli endpoint URL, dove il campo `url` accetta un array, e richiede una chiave privata più un piano con accesso al batch; il limite di batch del piano Founding è 0. Consulta [Elaborazione batch](/it/docs/guides/batch-processing.md). ### E se la mia coppia di formati non è tra le 51? Controlla prima `anything-to-pdf`: accetta 36 estensioni di input e copre coppie che non hanno un endpoint dedicato. Per testo che vuoi leggere anziché stampare, `anything-to-markdown` ne accetta 22. Nessuno dei due fa OCR, quindi un'immagine passata a `anything-to-markdown` restituisce `400`. ### Come trovo l'endpoint per una coppia di formati specifica? Apri la [Matrice di Conversione](/it/docs/endpoints/convert/matrix.md). Elenca ogni formato di input su un asse e ogni output sull'altro, con l'id dell'endpoint nella cella.