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 | 输入 | 额外字段 |
|---|---|---|
| merge | sourceKeys:2 个或更多 PDF,按顺序排列 | — |
| split | sourceKey | pages:从零开始编号的数组,例如 [0, 1, 4] 会保留第 1、2 和 5 页 |
| rotate | sourceKey | degrees:90、180 或 270 |
| compress | sourceKey | —(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 开始的页码。
可以压缩到指定大小吗?
此端点不支持。它只应用一种均衡的预设;如需精确的目标大小,可以使用网站上的“压缩到指定大小”工具。