Ta strona została przetłumaczona maszynowo. Zauważyłeś błąd?Pomóż ją ulepszyć.
Skip to content

PDF Multi-Tool ​

Złóż plik PDF z jawnego planu stron: zmień kolejność, duplikuj, obróć lub usuń strony oraz pobierz strony z dodatkowych plików PDF, wszystko w jednym żądaniu.

Punkt końcowy API ​

POST /api/v1/tools/pdf/multi-tool-pdf

Akceptuje dane formularza multipart z jednym lub większą liczbą plików PDF oraz polem JSON settings. W jednym żądaniu obsługiwane są maksymalnie 20 dokumentów wejściowych i 1 200 stron wyjściowych.

Parametry ​

ParametrTypWymaganyOpis
itemsarrayTakPlan stron wyjściowych w kolejności wyjściowej. Każdy element to { "doc": <int>, "page": <int>, "rot": <90|180|270, optional> }. doc indeksuje przesłane pliki w kolejności przesyłania (od 0); page to numer strony (od 1) w tym dokumencie.
pageCountsarrayTakRzeczywista liczba stron każdego przesłanego dokumentu, w tej samej kolejności. Strona planu wykraczająca poza liczbę stron dokumentu jest odrzucana z błędem 400.

Przykładowe żądanie ​

Weź strony 3 i 1 pierwszego dokumentu, a następnie strony 1 i 2 drugiego, obracając pierwszą stronę wyjściową o 90° zgodnie z ruchem wskazówek zegara:

bash
curl -X POST http://localhost:1349/api/v1/tools/pdf/multi-tool-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F 'settings={"items":[{"doc":0,"page":3,"rot":90},{"doc":0,"page":1},{"doc":1,"page":1},{"doc":1,"page":2}],"pageCounts":[3,2]}'

Przykładowa odpowiedź ​

json
{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document_multi-tool.pdf",
  "originalSize": 2450000,
  "processedSize": 2450000
}

Uwagi ​

  • Ta sama strona może pojawić się kilka razy w items, aby ją zduplikować.
  • Strony nieobecne w items są pomijane w wyniku.
  • rot zapisuje nową orientację wyświetlania na skopiowanej stronie (złożoną z ewentualnym istniejącym obrotem); zawartość strony pozostaje nietknięta.
  • Obrót jest stosowany dla każdej kopii wyjściowej, więc duplikaty mogą mieć różne obroty.
  • Wynik to nowy, płaski dokument; zakładki źródłowe i metadane na poziomie dokumentu nie są zachowywane.
  • Przetwarzanie wymaga binarki qpdf, która jest dołączona do oficjalnego obrazu Dockera.