Ottimizza API PDF
Ottimizzazione PDF strutturale senza perdita di dati utilizzando il ciclo di vita dell'attività sicura, con sanitizzazione metadati opzionale.
Semantica endpoint e attività#
Codice operazione: optimize
Avvia questa operazione con POST /v1/tasks e il codice dello strumento mostrato sopra. Carica e allega i PDF di origine (o usa gli endpoint di caricamento con ambito task), quindi chiama POST /v1/tasks/{task_id}/process con impostazioni di operazione.
Riduci la struttura dell'oggetto PDF ridondante prima dell'archiviazione e della consegna senza sostituire il testo selezionabile.
Input: Esattamente un PDF sigillato, un limite operativo di 100 MiB e 500 pagine; i limiti di upload/job e piano configurati potrebbero essere inferiori.
Configurazione e parametri aggiuntivi#
| Impostazione | Tipo | Comportamento |
|---|---|---|
| profile | balanced | lossless | Bilanciato pulisce i flussi di contenuto; senza perdita mantiene la struttura del flusso originale. Predefinito: balanced. |
| strip_metadata | boolean | Rimuovi anche metadati, JavaScript, testo nascosto e allegati. Predefinito: false. |
Le opzioni sono convalidate dall'API. Le impostazioni sconosciute e i valori non supportati restituiscono un errore invece di essere ignorati.
Sequenza di richiesta in corso#
Programming language: cURL
Scegli una lingua · scorri orizzontalmente per tutti i 10 linguaggi SDK
# Server-side API calls. Save the returned task_id.
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks' \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"tool":"optimize"}'
# Upload and verify 1 PDF(s), then obtain and approve a credit quote:
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID/quote' -H 'x-api-key: YOUR_API_KEY'
# ONLY after explicit customer approval:
test "$PDFHQ_APPROVE_QUOTE" = yes || { echo "Approval required" >&2; exit 1; }
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks/TASK_ID/process' \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"options":{"profile":"balanced","strip_metadata":false}}'
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID' -H 'x-api-key: YOUR_API_KEY'After starting a task, upload and verify PDFs, review the credit quote, and get explicit approval before processing. API keys belong on your server, never on signed storage uploads.
I pacchetti scaricabili generati coprono solo il flusso di lavoro dell'attività. Gli SDK full-service richiedono una specifica OpenAPI di runtime verificata; gli SDK delle attività Python, JavaScript e TypeScript trasmettono i caricamenti di file; gli altri linguaggi richiedono caricamenti multipart firmati implementati dal chiamante.
L'ID attività restituito viene utilizzato sia per il polling dello stato che per il recupero. Dopo il completamento dell'attività, richiedi un URL di output firmato anziché incorporare un segreto di download.
Output e dettagli importanti#
Nuovo PDF con riferimenti agli oggetti compattati e flussi deflazionati; numero di pagine preservato.
Si tratta di ottimizzazione strutturale, non di compressione di immagini con perdita. L'output potrebbe essere più grande. I moduli o le firme devono essere controllati dopo la riscrittura; le firme crittografiche non verranno conservate.
Errori, tentativi e fatturazione