跳到主要内容

查找下一个工具

文档/API/PDF API:合并、拆分、旋转和压缩
API

PDF API:合并、拆分、旋转和压缩

通过一个端点在云端合并多个 PDF、提取页面,以及旋转和压缩 PDF。

简要回答

调用 POST /api/v1/pdf-job/,将 operation 设为 merge、split、rotate 或 compress。merge 需要按顺序传入 sourceKeys,其他操作传入单个 sourceKey;split 在 "pages" 中接受从零开始编号的页码,rotate 接受取值为 90、180 或 270 的 "degrees"。文件来自直接上传,结果是一个新的 PDF 任务,可以像其他任务一样轮询。

操作

文件必须已经在你的账户存储中:请先上传,然后使用返回的 objectKey 值。

operation输入额外字段
mergesourceKeys:2 个或更多 PDF,按顺序排列—
splitsourceKeypages:从零开始编号的数组,例如 [0, 1, 4] 会保留第 1、2 和 5 页
rotatesourceKeydegrees:90、180 或 270
compresssourceKey—(Ghostscript 的“ebook”预设,图片为 150 dpi)

合并两个已上传的 PDF

要合并已经在线的 PDF,请发送 POST /api/v1/merge/,并按顺序附上包含 2–20 个 PDF URL 的 "files" 数组。消耗 1 积分,直接在响应中返回合并后的 PDF 而不是任务,在无代码工具中很方便。

curl -X POST 'https://maxscanner.app/api/v1/pdf-job/' \
  -H "Authorization: Bearer $MAXSCANNER_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: pack-8812-merge' \
  -d '{ "operation": "merge", "filename": "pack.pdf", "sourceKeys": ["users/<id>/media/inbox/…-cover.pdf", "users/<id>/media/inbox/…-contract.pdf"] }'

限制与行为

每个输入文件最大 100 MB,单个任务总计最大 150 MB。压缩会以约 150 dpi 重新写入图片,适合邮件发送和上传;本来就很小的纯文字 PDF 可能不会明显变小。加密的 PDF 必须先解锁。

常见问题

页码是从零开始的吗?

在 API 中是的:[0] 表示第一页。网站工具使用从 1 开始的页码。

可以压缩到指定大小吗?

此端点不支持。它只应用一种均衡的预设;如需精确的目标大小,可以使用网站上的“压缩到指定大小”工具。

相关指南