POST /api/pdf/merge ほか
生成後のPDFを思いのまま加工
マージ・分割・回転・圧縮・ページ番号付与・PDF/A変換・テキスト抽出・メタデータ操作。生成済みPDFを再アップロードすることなく、サーバー上のファイルへ直接ツールを適用できます。
この機能の主なポイント
1
8種のツールを共通APIで
merge / split / rotate / compress / page-numbers / to-pdfa / extract-text / metadata。すべて同じ認証・同じレスポンス形式。
2
サーバー上のファイルに直接適用
filename を指定するだけで再アップロード不要。ローカルPDFを上げたい場合は merge-upload で multipart 送信もできます。
3
出力もダウンロードURL付き
結果のPDFも有効期限・DL回数制限を設定可能。生成系APIと同じ運用ポリシーで扱えます。
使う場合 vs 使わない場合
| PDFツールAPIを使う | 自前で運用する | |
|---|---|---|
| 実装コスト | POSTするだけ | PDFLib/qpdf/Ghostscriptを統合 |
| 依存関係 | なし、認証ヘッダのみ | ネイティブライブラリのインストール |
| PDF/A変換 | 1b/2b/3b conformanceを指定 | Ghostscriptのプロファイル管理 |
| 向くケース | WebアプリやSaaSでPDF後処理 | オフライン専用ツール |
実装例
// Merge several already-generated PDFs into one
await fetch("/api/pdf/merge", {
method: "POST",
headers: { "Authorization": `Bearer ${API_KEY}` },
body: JSON.stringify({ filenames: ["invoice.pdf", "receipt.pdf"] }),
});
// Or upload + merge files in one request
// POST /api/pdf/merge-upload (multipart/form-data)
// Other endpoints follow the same shape:
// /api/pdf/split — split by page ranges
// /api/pdf/rotate — rotate pages
// /api/pdf/compress — shrink file size
// /api/pdf/page-numbers — stamp page numbers
// /api/pdf/to-pdfa — convert to PDF/A for archiving