Logo PDFHQ

Dokumenty

DokumentacjaPierwsze kroki

Błędy i ponowne próby interfejsu API

Ustrukturyzowane odpowiedzi na błędy, idempotencja i odzyskiwanie przetwarzania asynchronicznego.

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

Przewidywalne awarie protokołu HTTP#

401/403 wskazuje błąd uwierzytelnienia lub uprawnienia. 404 ukrywa niedostępne przedmioty. 409 sygnalizuje niezmienne ustawienia, już wykorzystane przesłania lub nieprawidłowy stan zadania. 413 egzekwuje ograniczenia rozmiaru, 422 zatwierdza ustawienia i 429 ogranicza szybkość/współbieżność.

Przejściowe awarie usług komercyjnych lub kolejek zwracają błąd 503. Spróbuj ponownie przetworzyć z tym samym identyfikatorem zadania i identycznymi opcjami, korzystając z wykładniczego wycofywania i ograniczonego budżetu ponownych prób.

Przykład odzyskiwania#

cURL
# Safe repeated processing attempt for the SAME task and options
curl -X POST https://api.pdfhq.io/v1/tasks/TASK_ID/process \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"options":{"compression_level":"recommended"}}'

Nie można cofnąć zadania przetwarzania zakończonego niepowodzeniem poprzez proste usunięcie zadania. Podczas sprawdzania rozbieżności w rozliczeniach należy skonsultować się z obsługą konta i pomocą techniczną.

Logo PDFHQ

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

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.