Logo PDFHQ

Dokumen

DokumentasiOperasi PDF

API Atur Halaman PDF

Susun ulang, putar, duplikat, dan hapus halaman PDF dalam satu tugas asinkron yang aman.

Kunci API sisi server Unggahan penyimpanan yang ditandatangani

Semantik endpoint dan tugas#

Kode operasi: organize

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.

Kumpulkan atau susun ulang dokumen tanpa memindai atau mengunggah ulang setiap halaman.

Input: Satu PDF terverifikasi, maksimal 500 halaman dan hingga 500 halaman keluaran; batas paket mungkin lebih rendah.

Konfigurasi dan parameter tambahan#

PengaturanJenisPerilaku
pageswajib {source:number,rotation:0|90|180|270}[]Urutan keluaran, nomor halaman sumber berbasis 1. Duplikat sumber berulang; sumber yang tidak ada dihapus. Rotasi searah jarum jam dan relatif terhadap rotasi asli.

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

API example · cURL
# 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":"organize"}'

# 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":{"pages":[{"source":3,"rotation":90},{"source":1,"rotation":0}]}}'

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.

All 10 SDKs ↓Panduan Python lengkap ↓ Panduan lengkap Bash/cURL ↓ Semua endpoint → Unggahan langsung → Penanganan kesalahan →

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 dalam urutan halaman yang diminta; asli dipertahankan sesuai kebijakan retensi.

Penulisan ulang merusak tanda tangan PDF kriptografi. PDF yang ditandatangani ditolak. Dokumen AcroForm dan PDF yang ditandatangani ditolak. Tautan internal dan penanda halaman mungkin tidak bertahan dari restrukturisasi halaman; tinjau sebelum mendistribusikan.

Kesalahan, percobaan ulang, dan penagihan
Logo PDFHQ

Alat PDF dan intelijen dokumen. Siapkan, pahami, dan bekerja dengan dokumen Anda.

© 2026 PDFHQ. Semua hak dilindungi.