Cliente de referencia de Python
Descarga el ejemplo de Python sin dependencias para cargas directas seguras, cotizaciones de HQTools, procesamiento asincrónico y descargas firmadas.
Implementación de referencia de Python#
El cliente de referencia implementa la cadena completa de tareas de documentos: crear una tarea, obtener un formulario de carga firmado, enviar el PDF directamente al almacenamiento, sellar la carga, solicitar una cotización de HQTools, enviar una tarea explícitamente aprobada, sondear y recuperar una URL de descarga firmada. Utiliza la biblioteca estándar de Python y no instala paquetes adicionales.
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"]Fuente: sdk/python/pdfhq/client.py en el repositorio PDFHQ. Esta es una implementación de referencia, no un paquete SDK publicado o versionado por separado. Transmite cargas multiparte firmadas con memoria acotada y rechaza rutas de finalización inesperadas.
Facturación, credenciales y reintentos#
Nunca expongas la clave API en JavaScript del navegador ni la envíes al punto final de almacenamiento firmado. La cotización es informativa; no reserva créditos. PDFHQ no reintenta automáticamente mutaciones inciertas o solicitudes de firma respaldadas por proveedores. Inspecciona la tarea o sobre existente antes de intentar la recuperación.
Referencia de error y reintento