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.
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#
| Ustawienie | Typ | Zachowanie |
|---|---|---|
| typewymagane | range | pages | size | Wybierz dokładnie jedną strategię podziału. |
| ranges | string | Kiedy typ=zakres; Zakresy oparte na 1, takie jak 1-3,4-8. |
| pages | string | Gdy typ=strony, wybrane numery stron, takie jak 1,4,7. |
| allPages | boolean | Kiedy type=pages, podziel każdą stronę. Domyślnie: false. |
| maxSize | number (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
# 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.
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