メインコンテンツへ移動

次に使うツールを探す

ドキュメント/API/PDF API:結合、分割、回転、圧縮
API

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入力追加フィールド
mergesourceKeys:2 つ以上の PDF を順番どおりに指定—
splitsourceKeypages:0 始まりの配列。例:[0, 1, 4] はページ 1、2、5 を残します
rotatesourceKeydegrees:90、180、270 のいずれか
compresssourceKey—(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 サイトのサイズ指定圧縮ツールを使ってください。

関連ガイド