---
seo_title: API da Documento a PDF per convertire file Office | EnConvert
meta_desc: Converti file Word, Excel, PowerPoint, HTML, Markdown, iWork e OpenDocument in PDF con un'unica API REST. Conversioni sincrone, byte PDF o URL prefirmati.
keywords: api da documento a pdf, convertire word in pdf api, convertire excel in pdf api, convertire powerpoint in pdf api, api html in pdf, api markdown in pdf, convertire odt in pdf, api conversione file office in pdf
---

# API da Documento a PDF

Gli endpoint di conversione da documento a PDF convertono file office e documenti (Microsoft Word, Excel e PowerPoint, Apple iWork Pages e Numbers, i formati OpenDocument, oltre a HTML e Markdown) in PDF di alta qualità tramite un'unica API REST. Ogni endpoint accetta un caricamento `multipart/form-data` e converte in modo sincrono, restituendo per impostazione predefinita i byte PDF grezzi oppure metadati JSON con un URL di download prefirmato. I formati Office e iWork vengono renderizzati lato server da LibreOffice mantenendo la formattazione, i font e il layout originali del documento, mentre HTML e Markdown vengono renderizzati con WeasyPrint e supportano dimensioni di pagina, margini, intestazioni e piè di pagina personalizzati tramite `pdf_options`.

## Conversioni supportate

| Conversione | Endpoint | Descrizione |
|------------|----------|-------------|
| [Da qualsiasi formato a PDF](/it/docs/endpoints/convert/documents/anything-to-pdf.md) | `POST /v1/convert/anything-to-pdf` | Endpoint jolly: accetta 36 estensioni di file (Office, iWork, OpenDocument, RTF, CSV, HTML, Markdown, testo, EPUB, immagini, SVG, PDF) e restituisce sempre un PDF. |
| [Da qualsiasi formato a Markdown](/it/docs/endpoints/convert/documents/anything-to-markdown.md) | `POST /v1/convert/anything-to-markdown` | Endpoint jolly: accetta 22 estensioni e restituisce sempre un singolo file Markdown UTF-8. Nessun OCR, quindi un'immagine restituisce `400`. |
| [Da HTML a PDF](/it/docs/endpoints/convert/documents/html-to-pdf.md) | `POST /v1/convert/html-to-pdf` | Renderizza i file `.html` o `.htm` in PDF con WeasyPrint, con dimensioni pagina, margini, orientamento, intestazioni e piè di pagina controllati tramite `pdf_options`. |
| [Da Markdown a PDF](/it/docs/endpoints/convert/documents/markdown-to-pdf.md) | `POST /v1/convert/markdown-to-pdf` | Converte i file `.md` o `.markdown` in PDF stilizzati con tabelle, blocchi di codice con syntax highlighting e un sommario `[TOC]` opzionale. |
| [Da Word a PDF](/it/docs/endpoints/convert/documents/doc-to-pdf.md) | `POST /v1/convert/doc-to-pdf` | Converte i documenti Microsoft Word `.doc` e `.docx` in PDF con LibreOffice, mantenendo font, formattazione e layout di pagina. |
| [Da Excel a PDF](/it/docs/endpoints/convert/documents/excel-to-pdf.md) | `POST /v1/convert/excel-to-pdf` | Converte i fogli di calcolo Microsoft Excel `.xlsx` e `.xls` in PDF con il rendering ad alta fedeltà di LibreOffice. |
| [Da PowerPoint a PDF](/it/docs/endpoints/convert/documents/ppt-to-pdf.md) | `POST /v1/convert/ppt-to-pdf` | Converte le presentazioni Microsoft PowerPoint `.ppt` e `.pptx` in PDF mantenendo la formattazione delle slide e i font. |
| [Da Pages a PDF](/it/docs/endpoints/convert/documents/pages-to-pdf.md) | `POST /v1/convert/pages-to-pdf` | Converte i documenti Apple iWork Pages `.pages` in PDF con rendering lato server tramite LibreOffice. |
| [Da Numbers a PDF](/it/docs/endpoints/convert/documents/numbers-to-pdf.md) | `POST /v1/convert/numbers-to-pdf` | Converte i fogli di calcolo Apple iWork Numbers `.numbers` in PDF mantenendo formattazione e layout. |
| [Da ODT a PDF](/it/docs/endpoints/convert/documents/odt-to-pdf.md) | `POST /v1/convert/odt-to-pdf` | Converte i file OpenDocument Text `.odt` (il formato nativo di LibreOffice/OpenOffice Writer) in PDF. |
| [Da ODS a PDF](/it/docs/endpoints/convert/documents/ods-to-pdf.md) | `POST /v1/convert/ods-to-pdf` | Converte i file OpenDocument Spreadsheet `.ods` di LibreOffice o OpenOffice Calc in PDF. |
| [Da ODP a PDF](/it/docs/endpoints/convert/documents/odp-to-pdf.md) | `POST /v1/convert/odp-to-pdf` | Converte i file OpenDocument Presentation `.odp` di LibreOffice o OpenOffice Impress in PDF. |
| [Da OTS a PDF](/it/docs/endpoints/convert/documents/ots-to-pdf.md) | `POST /v1/convert/ots-to-pdf` | Converte i file OpenDocument Spreadsheet Template `.ots` in PDF con il rendering di LibreOffice. |

## Convenzioni comuni

- **Autenticazione:** ogni endpoint richiede una chiave API privata tramite l'header `X-API-Key` oppure un JWT da chiave pubblica tramite `Authorization: Bearer`. Vedi [Autenticazione](/it/docs/authentication.md).
- **Formato della richiesta:** tutti gli endpoint accettano `multipart/form-data` con il documento nel campo `file`, più i campi opzionali `output_filename`, `direct_download` e `pdf_options`. Vedi [Job sync e async](/it/docs/concepts/sync-and-async.md).
- **Risposte sincrone:** le conversioni vengono eseguite in modo sincrono e restituiscono per impostazione predefinita i byte PDF grezzi (`application/pdf`); imposta `direct_download=false` per ricevere invece metadati JSON con `presigned_url`, `object_key`, `filename`, `file_size` e `conversion_time_seconds`.
- **Opzioni PDF:** HTML e Markdown (renderizzati con WeasyPrint) supportano il set completo di `pdf_options`, incluse dimensioni pagina, margini, orientamento, intestazioni e piè di pagina; i formati office basati su LibreOffice prendono il layout di pagina dal documento sorgente e supportano solo `grayscale`. Vedi [Job sync e async](/it/docs/concepts/sync-and-async.md).
- **Errori e limiti:** gli endpoint condividono la stessa semantica di errore: `400` per tipo di file errato o conversione non riuscita, `401` per credenziali mancanti/non valide, `402` quando la quota mensile di ops è esaurita o viene raggiunto il limite di storage, e `413` quando il file supera il limite di dimensione del piano. Vedi [Codici di errore](/it/docs/reference/errors.md).

## Domande frequenti

### Quali formati di documento posso convertire in PDF con l'API?

Sono supportati undici formati di input: HTML (`.html`, `.htm`), Markdown (`.md`, `.markdown`), Word (`.doc`, `.docx`), Excel (`.xlsx`, `.xls`), PowerPoint (`.ppt`, `.pptx`), Apple Pages (`.pages`), Apple Numbers (`.numbers`) e i formati OpenDocument `.odt`, `.ods`, `.odp` e `.ots`. Ognuno ha un proprio endpoint dedicato `POST /v1/convert/*`.

### Posso controllare dimensioni pagina, margini, intestazioni e piè di pagina nel PDF di output?

Solo sugli endpoint renderizzati con WeasyPrint (Da HTML a PDF e Da Markdown a PDF), dove `pdf_options` accetta `page_size`, larghezza/altezza personalizzate in millimetri, `orientation`, `margins` e `header`/`footer` con variabili di template come `{{page}}` e `{{total_pages}}`. Gli endpoint office basati su LibreOffice mantengono il layout di pagina originale del documento sorgente e supportano solo l'opzione `grayscale`.

### Come ottengo un URL di download invece dei byte PDF grezzi?

Imposta `direct_download=false` su qualsiasi endpoint. Invece del corpo PDF, la risposta è costituita da metadati JSON contenenti un `presigned_url` per scaricare il file, insieme a `object_key`, `filename`, `file_size` e `conversion_time_seconds`.