Logo PDFHQ

Dokumenty

DokumentacjaNarzędzia i odniesienia

Klient referencyjny Pythona

Pobierz niezależny od zależności przykład Python dla bezpiecznych bezpośrednich przesyłań, cytatów HQTools, asynchronicznego przetwarzania i podpisanych pobrań.

Klucze API po stronie serwera Podpisane przesyłanie danych do magazynu

Implementacja referencyjna Pythona#

Klient referencyjny implementuje kompletny łańcuch dokumentów i zadań: utwórz zadanie, uzyskaj podpisany formularz przesyłania, wyślij plik PDF bezpośrednio do magazynu, zapieczętuj przesyłanie, poproś o wycenę HQTools, prześlij wyraźnie zatwierdzone zadanie, odpytuj i pobierz podpisany adres URL pobierania. Korzysta ze standardowej biblioteki Pythona i nie instaluje dodatkowych pakietów.

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

Źródło: sdk/python/pdfhq/client.py w repozytorium PDFHQ. Jest to implementacja referencyjna, a nie osobno opublikowany lub wersjonowany pakiet SDK. Przesyła strumieniowo podpisane wieloczęściowe przesyłanie z ograniczoną pamięcią i odrzuca nieoczekiwane ścieżki zakończenia.

Rozliczenia, dane uwierzytelniające i ponowne próby#

Nigdy nie ujawniaj klucza API w JavaScript przeglądarki ani nie wysyłaj go do podpisanego punktu końcowego magazynu. Cytat ma charakter informacyjny; nie rezerwuje kredytów. PDFHQ nie ponawia automatycznie niepewnych mutacji ani żądań podpisu wspieranych przez dostawcę. Przed próbą odzyskania sprawdź istniejące zadanie lub kopertę.

Błąd i odwołanie do ponownej próby
Logo PDFHQ

Narzędzia PDF i inteligencja dokumentów. Przygotuj, zrozum i pracuj ze swoimi dokumentami.

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.