Optimalkan PDF API
Optimasi PDF struktural lossless menggunakan siklus hidup tugas aman, dengan sanitasi metadata opsional.
Semantik endpoint dan tugas#
Kode operasi: optimize
Mulai operasi ini dengan POST /v1/tasks dan kode alat yang ditampilkan di atas. Unggah dan lampirkan PDF sumber (atau gunakan titik akhir unggahan berskop tugas), lalu panggil POST /v1/tasks/{task_id}/process dengan pengaturan operasi.
Kurangi struktur objek PDF yang berlebihan sebelum pengarsipan dan pengiriman tanpa mengganti teks yang dapat dipilih.
Input: Tepat satu PDF tersegel, batas operasi 100 MiB dan 500 halaman; batas unggah/pekerjaan dan rencana yang dikonfigurasi mungkin lebih rendah.
Konfigurasi dan parameter tambahan#
| Pengaturan | Jenis | Perilaku |
|---|---|---|
| profile | balanced | lossless | Aliran konten pembersih seimbang; lossless mempertahankan struktur aliran asli. Bawaan: balanced. |
| strip_metadata | boolean | Juga hapus metadata, JavaScript, teks tersembunyi, dan lampiran. Bawaan: false. |
Opsi divalidasi oleh API. Pengaturan yang tidak dikenal dan nilai yang tidak didukung mengembalikan kesalahan alih-alih diabaikan.
Urutan permintaan yang sedang berjalan#
Programming language: cURL
Pilih bahasa · gulir secara horizontal untuk semua 10 bahasa 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.
Paket yang dapat diunduh yang dihasilkan mencakup alur kerja tugas saja. SDK layanan penuh memerlukan spesifikasi OpenAPI runtime yang terverifikasi; SDK tugas Python, JavaScript, dan TypeScript melakukan streaming unggahan file; bahasa lain memerlukan unggahan multipart yang ditandatangani yang diimplementasikan oleh pemanggil.
ID tugas yang dikembalikan digunakan untuk polling status dan pengambilan. Setelah tugas berhasil, minta URL output yang ditandatangani daripada menyematkan rahasia unduhan.
Output dan detail penting#
PDF baru dengan referensi objek yang dipadatkan dan aliran yang dikompres; jumlah halaman dipertahankan.
Ini adalah optimasi struktural, bukan kompresi gambar lossy. Output mungkin lebih besar. Formulir atau tanda tangan harus diperiksa setelah penulisan ulang; tanda tangan kriptografi tidak akan dipertahankan.
Kesalahan, percobaan ulang, dan penagihan