Klien referensi Python
Unduh contoh Python bebas dependensi untuk unggahan langsung yang aman, kutipan HQTools, pemrosesan asinkron, dan unduhan yang ditandatangani.
Implementasi referensi Python#
Klien referensi mengimplementasikan rantai tugas dokumen lengkap: buat tugas, dapatkan formulir unggah yang ditandatangani, kirim PDF langsung ke penyimpanan, segel unggahan, minta kutipan HQTools, kirim tugas yang disetujui secara eksplisit, polling dan ambil URL unduhan yang ditandatangani. Ini menggunakan perpustakaan standar Python dan tidak memasang paket tambahan.
from pdfhq import PDFHQClient
client = PDFHQClient("YOUR_API_KEY")
task = client.start("compress")
client.upload(task["task_id"], "report.pdf")
quote = client.quote(task["task_id"])
print("Estimated HQ credits:", quote["estimated_hq_credits"])
# Production systems should record approval in their own order flow.
if input("Approve this HQTools credit quote? Type yes: ").strip() != "yes":
raise SystemExit("No credit consumption authorized")
client.process(task["task_id"], {"compression_level": "recommended"})
result = client.wait(task["task_id"])
if result["status"] != "succeeded":
raise RuntimeError(result.get("error_code") or result["status"])
print("Download link available; avoid logging signed URLs")
url = client.download_url(task["task_id"])["url"]Sumber: sdk/python/pdfhq/client.py di repositori PDFHQ. Ini adalah implementasi referensi, bukan paket SDK yang dipublikasikan atau diversi secara terpisah. Ini melakukan streaming unggahan multipart yang ditandatangani dengan memori terbatas dan menolak jalur penyelesaian yang tidak terduga.
Penagihan, kredensial dan percobaan ulang#
Jangan pernah membuka kunci API di JavaScript browser atau mengirimnya ke titik akhir penyimpanan yang ditandatangani. Kutipan bersifat informatif; tidak mereservasi kredit. PDFHQ tidak secara otomatis mencoba ulang mutasi yang tidak pasti atau permintaan tanda tangan yang didukung penyedia. Periksa tugas atau amplop yang ada sebelum mencoba pemulihan.
Referensi kesalahan dan percobaan ulang