本页面由机器翻译。发现错误了吗?帮助改进它。
Skip to content

PDF 多功能工具 ​

通过显式的页面计划组装 PDF:重新排序、复制、旋转或删除页面,并从其他 PDF 拉取页面,所有操作在一个请求中完成。

API 端点 ​

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

接受包含一个或多个 PDF 文件和一个 JSON settings 字段的 multipart 表单数据。 每个请求最多支持 20 个输入文档和 1,200 个输出页面。

参数 ​

参数类型必填描述
itemsarray是按输出顺序排列的输出页面计划。每个条目为 { "doc": <int>, "page": <int>, "rot": <90|180|270, optional> }。doc 以上传顺序索引上传的文件(从 0 开始);page 是该文档中基于 1 的页码。
pageCountsarray是每个上传文档的实际页数,顺序相同。计划中的页面超出其文档页数时,会以 400 拒绝。

请求示例 ​

取第一份文档的第 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]}'

响应示例 ​

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

注意事项 ​

  • 同一页面可以在 items 中出现多次以复制它。
  • 未出现在 items 中的页面将从输出中省略。
  • rot 记录复制页面上的新显示方向(与任何现有旋转组合);页面内容不会被修改。
  • 旋转按每个输出副本应用,因此副本可以有不同的旋转。
  • 输出是一个新的扁平文档;源书签和文档级元数据不会保留。
  • 处理需要 qpdf 二进制文件,该文件包含在官方 Docker 镜像中。