Logo PDFHQ

Dokumenty

DokumentacjaPierwsze kroki

Idempotencja i bezpieczeństwo ponawiania prób

Bezpiecznie ponawiaj próby tworzenia zadania dokumentu po przekroczeniu limitu czasu sieci, korzystając z nagłówków Idempotency-Key o zasięgu projektu i odróżniaj je od płatnego procesu i wysyłania dostawcy.

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

Tworzenie zadań z możliwością ponownego odtwarzania#

POST /v1/tasks akceptuje opcję Idempotency-Key (8–128 liter ASCII, cyfr, kropek, podkreśleń, dwukropków lub łączników; zaczyna się od litery lub cyfry). Powtórzenie klucza dla tego samego konta HQTools i projektu API powoduje zwrócenie istniejącego zadania. Ponowne użycie tego samego klucza dla innego narzędzia powoduje powrót 409 IDEMPOTENCY_KEY_REUSED.

Utwórz zadanie z kluczem ponownej próby
curl -q --fail-with-body -X POST 'https://api.pdfhq.io/v1/tasks' \
  -H 'x-api-key: YOUR_SERVER_SIDE_API_KEY' \
  -H 'Idempotency-Key: job-20261025-00001' \
  -H 'Content-Type: application/json' \
  -d '{"tool":"compress"}'

Zwrócony identyfikator zadania jest stabilny przy kolejnych próbach. Klucze są ograniczone do konta i projektu interfejsu API i pozostają powiązane z zadaniem do czasu wyczyszczenia podstawowego rekordu. Utwórz nowy klucz dla nowego zadania.

Różne reguły ponawiania prób dla różnych zasobów#

Tworzenie zadania: odtwórz ponownie przy użyciu tego samego klucza Idempotency po przerwie w sieci. Przetwarzanie zadań: ustalony identyfikator zadania zapewnia już idempotencję zadania/kredytu zaplecza dla identycznych opcji; sprawdź jego stan przed ponowną próbą. Zadania AI: użyj nowego, zatwierdzonego przez użytkownika cytatu i stabilnego klucza Idempotencji obsługiwanego przez punkt końcowy AI. Wyślij e-podpis: niepewna odpowiedź dostawcy wymaga uzgodnienia koperty; nie wysyłaj ponownie żądania podpisu bez zastanowienia.

Podpisane przesyłanie S3 korzysta z krótkotrwałych zasad formularza POST. Nie wysyłaj x-api-key lub Klucz Idempotencji do S3. Przesyłanie danych do magazynu i szacunkowa wycena same w sobie nie powodują naliczenia kredytów; przetwarzanie tak.

Logo PDFHQ

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

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.