Эта страница переведена машинным способом. Заметили ошибку?Помогите её улучшить.
Skip to content

PDF Multi-Tool ​

Соберите PDF по явному плану страниц: переупорядочивайте, дублируйте, поворачивайте или удаляйте страницы и извлекайте страницы из дополнительных PDF за один запрос.

API Endpoint ​

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

Принимает multipart-данные формы с одним или несколькими PDF-файлами и полем JSON settings. За один запрос поддерживается до 20 входных документов и 1200 выходных страниц.

Parameters ​

ParameterTypeRequiredDescription
itemsarrayYesПлан выходных страниц в порядке вывода. Каждый элемент, { "doc": <int>, "page": <int>, "rot": <90|180|270, optional> }. doc индексирует загруженные файлы в порядке загрузки (с нуля); page, номер страницы в этом документе (с единицы).
pageCountsarrayYesРеальное количество страниц каждого загруженного документа в том же порядке. Страница плана, выходящая за пределы количества страниц своего документа, отклоняется с кодом 400.

Example Request ​

Возьмите страницы 3 и 1 первого документа, затем страницы 1 и 2 второго, повернув первую выходную страницу на 90° по часовой стрелке:

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]}'

Example Response ​

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

Notes ​

  • Одну и ту же страницу можно указать в items несколько раз, чтобы дублировать её.
  • Страницы, отсутствующие в items, не попадают в вывод.
  • rot записывает новую ориентацию отображения на скопированной странице (в сочетании с существующим поворотом); содержимое страницы не изменяется.
  • Поворот применяется к каждой выходной копии, поэтому у дубликатов могут быть разные повороты.
  • Вывод, новый плоский документ; исходные закладки и метаданные уровня документа не сохраняются.
  • Для обработки требуется бинарный файл qpdf, который входит в официальный образ Docker.