跳至主要內容

尋找下一個工具

說明文件/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 網址的 "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 開始的頁碼。

可以壓縮到指定大小嗎?

此端點不支援。它只套用一種平衡的預設集;如需精確的目標大小,可以使用網站上的「壓縮到指定大小」工具。

相關指南