PDF-API optimieren
Verlustfreie strukturelle PDF-Optimierung mit sicherem Task-Lebenszyklus und optionaler Metadaten-Bereinigung.
Endpunkt- und Task-Semantik#
Operationscode: optimize
Starten Sie diesen Vorgang mit POST /v1/tasks und den oben angezeigten Tool-Code. Lade Quell-PDFs hoch und füge sie an (oder verwende Task-bezogene Upload-Endpunkte), dann rufe auf POST /v1/tasks/{task_id}/process mit Operationseinstellungen.
Reduziere redundante PDF-Objektstruktur vor Archivierung und Lieferung, ohne wählbaren Text zu ersetzen.
Eingaben: Genau eine versiegelte PDF, ein Operationslimit von 100 MiB und 500 Seiten; konfigurierte Upload-/Job- und Planlimits können niedriger sein.
Konfiguration und zusätzliche Parameter#
| Einstellung | Typ | Verhalten |
|---|---|---|
| profile | balanced | lossless | Ausgewogene Reinigung von Inhaltsströmen; verlustfrei behält die ursprüngliche Stromstruktur bei. Standard: balanced. |
| strip_metadata | boolean | Entferne auch Metadaten, JavaScript, versteckte Texte und Anhänge. Standard: false. |
Optionen werden von der API validiert. Unbekannte Einstellungen und nicht unterstützte Werte geben einen Fehler zurück, statt ignoriert zu werden.
Arbeitende Anforderungssequenz#
Programming language: cURL
Wähle eine Sprache · scrolle horizontal für alle 10 SDK-Sprachen
# 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.
Generierte herunterladbare Pakete decken nur den Task-Workflow ab. Vollständige SDKs erfordern eine verifizierte OpenAPI-Spezifikation; die Python-, JavaScript- und TypeScript-Task-SDKs streamen Datei-Uploads; die anderen Sprachen erfordern signierte Multipart-Uploads, die vom Aufrufer implementiert werden.
Die zurückgegebene Aufgaben-ID wird sowohl für die Statusabfrage als auch für den Abruf verwendet. Nachdem die Aufgabe erfolgreich war, fordern Sie eine signierte Ausgabe-URL an, anstatt ein Download-Geheimnis einzubetten.
Ausgabe und wichtige Details#
Neue PDF mit kompakten Objektreferenzen und deflatierten Streams; Seitenzahl bleibt erhalten.
Dies ist strukturelle Optimierung, keine verlustbehaftete Bildkompression. Die Ausgabe kann größer sein. Formulare oder Signaturen müssen nach dem Umschreiben überprüft werden; kryptografische Signaturen werden nicht beibehalten.
Fehler, Wiederholungen und Abrechnung