Cliente de referência Python
Baixe o exemplo Python sem dependências para uploads diretos seguros, cotações HQTools, processamento assíncrono e downloads assinados.
Implementação de referência Python#
O cliente de referência implementa a cadeia completa de tarefas de documentos: criar uma tarefa, obter um formulário de upload assinado, enviar o PDF diretamente para armazenamento, selar o upload, solicitar uma cotação HQTools, enviar uma tarefa explicitamente aprovada, pesquisar e recuperar uma URL de download assinada. Usa a biblioteca padrão do Python e não instala pacotes adicionais.
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 no repositório PDFHQ. Esta é uma implementação de referência, não um pacote SDK publicado ou versionado separadamente. Ele transmite uploads multipart assinados com memória limitada e rejeita caminhos de conclusão inesperados.
Faturação, credenciais e tentativas#
Nunca exponha a chave de API em JavaScript do navegador ou envie-a para o endpoint de armazenamento assinado. A cotação é informativa; não reserva créditos. PDFHQ não tenta automaticamente novamente mutações incertas ou solicitações de assinatura com suporte de provedor. Inspecione a tarefa ou envelope existente antes de tentar recuperação.
Referência de erro e repetição