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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | POST /v1/convert/ods-to-pdf |
Converte i file OpenDocument Spreadsheet .ods di LibreOffice o OpenOffice Calc in PDF. |
| Da ODP a PDF | POST /v1/convert/odp-to-pdf |
Converte i file OpenDocument Presentation .odp di LibreOffice o OpenOffice Impress in PDF. |
| Da OTS a PDF | 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-Keyoppure un JWT da chiave pubblica tramiteAuthorization: Bearer. Vedi Autenticazione. - Formato della richiesta: tutti gli endpoint accettano
multipart/form-datacon il documento nel campofile, più i campi opzionalioutput_filename,direct_downloadepdf_options. Vedi Job sync e async. - Risposte sincrone: le conversioni vengono eseguite in modo sincrono e restituiscono per impostazione predefinita i byte PDF grezzi (
application/pdf); impostadirect_download=falseper ricevere invece metadati JSON conpresigned_url,object_key,filename,file_sizeeconversion_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 solograyscale. Vedi Job sync e async. - Errori e limiti: gli endpoint condividono la stessa semantica di errore:
400per tipo di file errato o conversione non riuscita,401per credenziali mancanti/non valide,402quando la quota mensile di ops è esaurita o viene raggiunto il limite di storage, e413quando il file supera il limite di dimensione del piano. Vedi Codici di errore.
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.