API PDF: unire, dividere, ruotare e comprimere
Unisci più PDF, estrai pagine, ruota e comprimi PDF nel cloud con un solo endpoint.
Risposta breve
Invia POST /api/v1/pdf-job/ con un'operation tra merge, split, rotate o compress. Passa sourceKeys (in ordine) per merge, oppure un singolo sourceKey per le altre; split accetta in "pages" numeri di pagina a base zero e rotate accetta "degrees" pari a 90, 180 o 270. I file provengono da un caricamento diretto e il risultato è un nuovo job PDF da interrogare come qualsiasi altro.
Operazioni
I file devono essere già nello storage del tuo account: caricali prima e usa i valori objectKey restituiti.
| operation | Input | Campi aggiuntivi |
|---|---|---|
| merge | sourceKeys: 2 o più PDF, in ordine | — |
| split | sourceKey | pages: array a base zero, ad es. [0, 1, 4] mantiene le pagine 1, 2 e 5 |
| rotate | sourceKey | degrees: 90, 180 o 270 |
| compress | sourceKey | — (profilo "ebook" di Ghostscript, immagini a 150 dpi) |
Unire due PDF caricati
Per unire PDF già online, invia POST /api/v1/merge/ con un array "files" di 2–20 URL di PDF nell’ordine voluto. Costa 1 credito e restituisce direttamente il PDF unito nella risposta invece di un job, comodo negli strumenti no-code.
curl -X POST 'https://maxscanner.app/api/v1/pdf-job/' \
-H "Authorization: Bearer $MAXSCANNER_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: pack-8812-merge' \
-d '{ "operation": "merge", "filename": "pack.pdf", "sourceKeys": ["users/<id>/media/inbox/…-cover.pdf", "users/<id>/media/inbox/…-contract.pdf"] }'Limiti e comportamento
Ogni input può arrivare a 100 MB e un job a 150 MB in totale. La compressione riscrive le immagini a circa 150 dpi, una risoluzione adatta a email e caricamenti; i PDF di solo testo già leggeri potrebbero ridursi di poco. I PDF crittografati vanno sbloccati prima.
Domande frequenti
I numeri di pagina partono da zero?
Nell'API sì: [0] è la prima pagina. Gli strumenti del sito usano numeri che partono da 1.
Posso comprimere fino a una dimensione esatta?
Non con questo endpoint, che applica un unico profilo bilanciato; per obiettivi esatti il sito offre uno strumento che comprime fino a una dimensione specifica.