PDF API:結合、分割、回転、圧縮
1 つのエンドポイントで、複数の PDF の結合、ページの抽出、PDF の回転と圧縮をクラウドで行えます。
要点
operation に merge、split、rotate、compress のいずれかを指定して POST /api/v1/pdf-job/ を送信します。merge には sourceKeys(順番どおり)を、それ以外には 1 つの sourceKey を渡します。split は "pages" に 0 始まりのページ番号を、rotate は "degrees" に 90、180、270 のいずれかを指定します。ファイルは直接アップロードで渡し、結果は新しい PDF ジョブとして、他のジョブと同様にポーリングします。
操作
ファイルはあらかじめアカウントのストレージにある必要があります。先にアップロードし、返された objectKey の値を使ってください。
| operation | 入力 | 追加フィールド |
|---|---|---|
| merge | sourceKeys:2 つ以上の PDF を順番どおりに指定 | — |
| split | sourceKey | pages:0 始まりの配列。例:[0, 1, 4] はページ 1、2、5 を残します |
| rotate | sourceKey | degrees:90、180、270 のいずれか |
| compress | sourceKey | —(Ghostscript の "ebook" プロファイル、画像は 150 dpi) |
アップロードした 2 つの PDF を結合する
すでにオンラインにある PDF を結合するには、2–20 個の PDF URL を順番に並べた "files" 配列を付けて POST /api/v1/merge/ を送信します。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、1 つのジョブの合計は最大 150 MB です。圧縮では画像を約 150 dpi で書き直すため、メールやアップロードに適したサイズになります。もともと小さいテキスト中心の PDF は、あまり小さくならない場合があります。暗号化された PDF は、先にロックを解除する必要があります。
よくある質問
ページ番号は 0 始まりですか?
はい、API では [0] が最初のページです。Web サイトのツールでは 1 始まりの番号を使います。
正確なサイズに圧縮できますか?
このエンドポイントではできません。適用されるのは、バランスを重視した 1 つのプロファイルだけです。正確なサイズを目標にする場合は、Web サイトのサイズ指定圧縮ツールを使ってください。