Logo PDFHQ

Documents

DocumentationOutils et référence

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.

Clés API côté serveur Importations de stockage signées

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.

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

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
Logo PDFHQ

Outils PDF et intelligence documentaire. Préparez, comprenez et travaillez avec vos documents.

© 2026 PDFHQ. Tous droits réservés.