Logo PDFHQ

Dokumenty

DokumentacjaOperacje w formacie PDF

Podzielone API PDF

Podziel plik PDF według zakresów stron, wybranych stron lub docelowego rozmiaru części. Każda strategia ma własne ustawienia warunkowe.

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

Semantyka punktów końcowych i zadań#

Kod operacji: split

Rozpocznij tę operację za pomocą POST /v1/tasks oraz kod narzędzia pokazany powyżej. Prześlij i dołącz źródłowe pliki PDF (lub użyj punktów końcowych przesyłania o zakresie zadań), a następnie zadzwoń POST /v1/tasks/{task_id}/process z ustawieniami operacyjnymi.

Rozdziel duże pakiety na osobne pliki w celu późniejszego przeglądu.

Wejścia: Dokładnie jedno zweryfikowane przesłanie PDF.

Konfiguracja i dodatkowe parametry#

UstawienieTypZachowanie
typewymagane range | pages | sizeWybierz dokładnie jedną strategię podziału.
rangesstringKiedy typ=zakres; Zakresy oparte na 1, takie jak 1-3,4-8.
pagesstringGdy typ=strony, wybrane numery stron, takie jak 1,4,7.
allPagesbooleanKiedy type=pages, podziel każdą stronę. Domyślnie: false.
maxSizenumber (MB)Wymagane, gdy typ=rozmiar; większy niż 0 i maksymalnie 50 MB.

Opcje są sprawdzane przez API. Nieznane ustawienia i nieobsługiwane wartości zwracają błąd zamiast być ignorowane.

Robocza sekwencja żądań#

Programming language: cURL

Wybierz język · przewiń w poziomie, aby zobaczyć wszystkie 10 języków SDK

API example · cURL
# Server-side API calls. Save the returned task_id.
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"tool":"split"}'

# Upload and verify 1 PDF(s), then obtain and approve a credit quote:
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID/quote' -H 'x-api-key: YOUR_API_KEY'

# ONLY after explicit customer approval:
test "$PDFHQ_APPROVE_QUOTE" = yes || { echo "Approval required" >&2; exit 1; }
curl -fsS -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":{"type":"range","ranges":"1-3,4-8"}}'

curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID' -H 'x-api-key: YOUR_API_KEY'

After starting a task, upload and verify PDFs, review the credit quote, and get explicit approval before processing. API keys belong on your server, never on signed storage uploads.

All 10 SDKs ↓Ukończ przewodnik po Pythonie ↓ Ukończ instruktaż Bash/cURL ↓ Wszystkie punkty końcowe → Przesyłanie bezpośrednie → Obsługa błędów →

Wygenerowane pakiety do pobrania obejmują wyłącznie przebieg zadania. Zestawy SDK z pełną obsługą wymagają zweryfikowanej specyfikacji OpenAPI środowiska wykonawczego; przesyłanie strumieniowych plików SDK zadań Python, JavaScript i TypeScript; inne języki wymagają podpisanego przesyłania wieloczęściowego realizowanego przez osobę wywołującą.

Zwrócony identyfikator zadania jest używany zarówno do odpytywania stanu, jak i pobierania. Po pomyślnym wykonaniu zadania poproś o podpisany wyjściowy adres URL, zamiast osadzać klucz tajny pobierania.

Dane wyjściowe i ważne szczegóły#

Archiwum ZIP wyodrębnionych części PDF.

Numery stron są oparte na 1. Zweryfikuj żądane strony względem dokumentu źródłowego.

Błędy, ponowne próby i rozliczenia
Logo PDFHQ

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

© 2026 PDFHQ. Wszystkie prawa zastrzeżone.