Client de référence Python
Téléchargez l'exemple Python sans dépendance pour les importations directes sécurisées, les devis HQTools, le traitement asynchrone et les téléchargements signés.
Implémentation de référence Python#
Le client de référence met en œuvre la chaîne complète document-tâche : créer une tâche, obtenir un formulaire de téléchargement signé, envoyer le PDF directement au stockage, sceller le téléchargement, demander un devis HQTools, soumettre une tâche explicitement approuvée, interroger et récupérer une URL de téléchargement signée. Il utilise la bibliothèque standard de Python et n'installe pas de packages supplémentaires.
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"]Source : sdk/python/pdfhq/client.py dans le référentiel PDFHQ. Il s'agit d'une implémentation de référence, pas d'un package SDK publié ou versionné séparément. Il diffuse les téléchargements multipartites signés avec mémoire limitée et rejette les chemins d'achèvement inattendus.
Facturation, identifiants et tentatives#
N'exposez jamais la clé API dans JavaScript du navigateur et ne l'envoyez pas au point de terminaison de stockage signé. Le devis est informatif ; il ne réserve pas de crédits. PDFHQ ne réessaie pas automatiquement les mutations incertaines ou les demandes de signature soutenues par un fournisseur. Inspectez la tâche ou l'enveloppe existante avant de tenter une récupération.
Référence des erreurs et des tentatives