PDFHQ-logo

Documenten

DocumentatieHulpmiddelen en referentie

Python-referentieclient

Download het afhankelijkheidsvrije Python-voorbeeld voor veilige directe uploads, HQTools-offertes, asynchrone verwerking en ondertekende downloads.

Server-side API-sleutels Ondertekende opslagupload

Python-referentie-implementatie#

De referentieclient implementeert de volledige documenttaakketen: maak een taak, verkrijg een ondertekend uploadformulier, stuur de PDF rechtstreeks naar opslag, verzegel de upload, vraag een HQTools-offerte aan, dien een expliciet goedgekeurde taak in, poll en haal een ondertekende download-URL op. Het gebruikt Python's standaardbibliotheek en installeert geen aanvullende pakketten.

cURL
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"]

Bron: sdk/python/pdfhq/client.py in de PDFHQ-repository. Dit is een referentie-implementatie, geen afzonderlijk gepubliceerde of versioned SDK-pakket. Het streamt ondertekende multipart-uploads met begrensd geheugen en wijst onverwachte voltooiingspaden af.

Facturering, inloggegevens en pogingen#

Stel de API-sleutel nooit bloot in browserJavaScript of stuur deze naar het ondertekende opslageindpunt. Het offerte is informatief; het reserveert geen tegoed. PDFHQ voert onzekere mutaties of door provider ondersteunde handtekeningverzoeken niet automatisch opnieuw uit. Controleer de bestaande taak of envelop voordat u herstel probeert.

Fout- en herproberingverwijzing
PDFHQ-logo

PDF-tools en documentintelligentie. Bereid, begrijp en werk met uw documenten.

© 2026 PDFHQ. Alle rechten voorbehouden.