Client di riferimento Python
Scarica l'esempio Python senza dipendenze per caricamenti diretti sicuri, preventivi HQTools, elaborazione asincrona e download firmati.
Implementazione di riferimento Python#
Il client di riferimento implementa la catena completa di attività documento: crea un'attività, ottieni un modulo di caricamento firmato, invia il PDF direttamente all'archiviazione, sigilla il caricamento, richiedi un preventivo HQTools, invia un'attività esplicitamente approvata, esegui il polling e recupera un URL di download firmato. Utilizza la libreria standard di Python e non installa pacchetti aggiuntivi.
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"]Fonte: sdk/python/pdfhq/client.py nel repository PDFHQ. Questa è un'implementazione di riferimento, non un pacchetto SDK pubblicato o versionato separatamente. Trasmette caricamenti multipart firmati con memoria limitata e rifiuta percorsi di completamento inaspettati.
Fatturazione, credenziali e tentativi#
Non esporre mai la chiave API in JavaScript del browser o inviarla all'endpoint di archiviazione firmato. Il preventivo è informativo; non riserva crediti. PDFHQ non ritenta automaticamente mutazioni incerte o richieste di firma supportate da provider. Ispeziona l'attività o la busta esistente prima di tentare il recupero.
Riferimento errori e tentativi