Uporządkuj interfejs API stron PDF
Zmieniaj kolejność, obracaj, duplikuj i usuwaj strony PDF w jednym bezpiecznym zadaniu asynchronicznym.
Semantyka punktów końcowych i zadań#
Kod operacji: organize
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.
Złóż lub zmień kolejność dokumentu bez skanowania lub ponownego przesyłania każdej strony.
Wejścia: Jeden zweryfikowany plik PDF, maksymalnie 500 stron i do 500 stron wyjściowych; limity planu mogą być niższe.
Konfiguracja i dodatkowe parametry#
| Ustawienie | Typ | Zachowanie |
|---|---|---|
| pageswymagane | {source:number,rotation:0|90|180|270}[] | Sekwencja wyjściowa, numery stron źródłowych oparte na 1. Powtarzające się duplikaty źródeł; brak źródła usuwa. Obrót odbywa się zgodnie z ruchem wskazówek zegara i względem pierwotnego obrotu. |
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":"organize"}'
# 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":{"pages":[{"source":3,"rotation":90},{"source":1,"rotation":0}]}}'
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#
Nowy plik PDF w żądanej kolejności stron; oryginał zachowany zgodnie z polityką przechowywania.
Przepisanie łamie kryptograficzne podpisy PDF. Podpisane pliki PDF są odrzucane. Dokumenty AcroForm i podpisane pliki PDF są odrzucane. Wewnętrzne linki i zakładki mogą nie przetrwać restrukturyzacji strony; sprawdź przed dystrybucją.
Błędy, ponowne próby i rozliczenia