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 網址的 "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 開始的頁碼。
可以壓縮到指定大小嗎?
此端點不支援。它只套用一種平衡的預設集;如需精確的目標大小,可以使用網站上的「壓縮到指定大小」工具。