Logo PDFHQ

Dokumenty

DokumentacjaPierwsze kroki

Weryfikacja przed przesłaniem

Sprawdź uprawnienia do operacji PDF, podpisane metadane, limity pakietów i szacowane kredyty HQ przed zapieczętowaniem lub przesłaniem plików.

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

Sprawdź operacje PDF bez przesyłania plików#

POST /v1/preflight sprawdza planowaną operację PDF, metadane, ustawienia, ograniczenia planu i orientacyjny koszt w kredytach HQ bez przydzielania miejsca, tworzenia zadania ani pobierania kredytów. Podaj format, size_bytes i page_count dla każdego pliku. Uwierzytelnianie odbywa się przez sesję konta lub klucz API z uprawnieniami do zadań; ograniczone żądania anonimowe nie mogą odczytywać salda.

cURL
curl -X POST 'https://api.pdfhq.io/v1/preflight'   -H 'Content-Type: application/json'   -H 'x-api-key: YOUR_API_KEY'   -d '{"operation":"merge","inputs":[{"format":"pdf","size_bytes":51200,"page_count":2},{"format":"pdf","size_bytes":40960,"page_count":3}],"file_count":2,"settings":{}}'

Sprawdź supported, eligible, can_proceed, blockers, quote i next_actions. Tylko oferta zweryfikowana centralnie przez HQTools może usunąć blokadę możliwą do rozwiązania zakupem. Technicznie nieobsługiwane żądanie nie może wyświetlać ekranu płatności.

Wykonywanie i bezpieczeństwo#

Limity żądań i ścisła walidacja chronią anonimowy punkt dostępu. Pomyślna weryfikacja wstępna nie rezerwuje kredytów, nie ustala ceny ani nie potwierdza zawartości przesłanych PDF-ów. Podpisz i prześlij bezpośrednio do pamięci, utwórz zadanie i pozwól serwerowi ponownie sprawdzić rzeczywiste dokumenty, uprawnienia, limity i kredyty HQ podczas wykonania.

Referencyjne zestawy SDK udostępniają preflight(request) w dziesięciu językach, a aktualny dokument OpenAPI /openapi.json opisuje publiczne kontrakty. Obsługuj odpowiedzi HTTP 422 (walidacja), 429 (limit żądań) i 503 (niedostępność).

Logo PDFHQ

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

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.