Zoptymalizuj interfejs API PDF
Bezstratna strukturalna optymalizacja plików PDF przy użyciu bezpiecznego cyklu życia zadań z opcjonalnym oczyszczaniem metadanych.
Semantyka punktów końcowych i zadań#
Kod operacji: optimize
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.
Zredukuj zbędną strukturę obiektów PDF przed archiwizacją i dostarczeniem, bez zastępowania wybieralnego tekstu.
Wejścia: Dokładnie jeden zapieczętowany plik PDF, maksymalny rozmiar operacji wynoszący 100 MiB i 500 stron; skonfigurowane limity przesyłania/zadań i planu mogą być niższe.
Konfiguracja i dodatkowe parametry#
| Ustawienie | Typ | Zachowanie |
|---|---|---|
| profile | balanced | lossless | Zrównoważony czyści strumienie treści; bezstratny zachowuje oryginalną strukturę strumienia. Domyślnie: balanced. |
| strip_metadata | boolean | Usu ń także metadane, JavaScript, ukryty tekst i załączniki. Domyślnie: false. |
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":"optimize"}'
# 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":{"profile":"balanced","strip_metadata":false}}'
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 ze skompaktowanymi odniesieniami do obiektów i deflowanymi strumieniami; liczba stron zachowana.
Jest to optymalizacja strukturalna, a nie stratna kompresja obrazu. Wyjście może być większe. Formularze lub podpisy należy sprawdzić po przepisaniu; podpisy kryptograficzne nie zostaną zachowane.
Błędy, ponowne próby i rozliczenia