Vai al contenuto principale

Trova il prossimo strumento

Documentazione/API/API PDF: unire, dividere, ruotare e comprimere
API

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.

operationInputCampi aggiuntivi
mergesourceKeys: 2 o più PDF, in ordine—
splitsourceKeypages: array a base zero, ad es. [0, 1, 4] mantiene le pagine 1, 2 e 5
rotatesourceKeydegrees: 90, 180 o 270
compresssourceKey— (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.

Guide correlate