# PDF をファイルサイズで分割する PDF を、最大バイトサイズを超えない複数の小さなドキュメントに分割します。 PDF ドキュメントを、バイト単位の最大ファイルサイズを超えない複数の小さなドキュメントに分割します。このアクションは複数のドキュメントを返し、`Accept` ヘッダーに応じて1つのレスポンスにまとめられます。この API はステートレスです。ドキュメントはリージョン内で処理され、保存されることはありません。 ## エンドポイント <Endpoint method="POST" path="/v1/split_by_size" /> すべてのリージョンで利用できます。ルーティングとデータの保存地域については [リージョンとデータの保存地域](/docs/api/regions-and-data-residency) を参照してください。 | リージョン | URL | | --- | --- | | グローバル | `https://api.pdfblocks.com/v1/split_by_size` | | 日本 | `https://jp.api.pdfblocks.com/v1/split_by_size` | | 米国 | `https://us.api.pdfblocks.com/v1/split_by_size` | | HIPAA 米国 | `https://hipaa.api.pdfblocks.com/v1/split_by_size` | | 欧州連合 | `https://eu.api.pdfblocks.com/v1/split_by_size` | | 英国 | `https://uk.api.pdfblocks.com/v1/split_by_size` | | カナダ | `https://ca.api.pdfblocks.com/v1/split_by_size` | | オーストラリア | `https://au.api.pdfblocks.com/v1/split_by_size` | | インド | `https://in.api.pdfblocks.com/v1/split_by_size` | | ブラジル | `https://br.api.pdfblocks.com/v1/split_by_size` | ## 認証 すべてのリクエストは、HTTPS 経由で `X-API-Key` ヘッダーにシークレット API キーを設定して認証してください。キーの作成と管理は [ダッシュボード](https://dashboard.pdfblocks.com) から行えます。詳細は [認証](/docs/api/authentication) を参照してください。 ## リクエスト このエンドポイントは `multipart/form-data` 形式のリクエストボディを受け付けます。 <ParamField name="file" type="file" required> 入力する PDF ドキュメント。 </ParamField> <ParamField name="maximum_bytes" type="integer" required> 各出力 PDF の最大サイズ（バイト単位）。`1` 以上を指定する必要があります。 </ParamField> ## サンプル 各パートが最大 1MB になるようにドキュメントを分割します。 <CodeGroup> ```bash title="cURL" curl https://api.pdfblocks.com/v1/split_by_size \ -H 'X-API-Key: your_api_key' \ -F file=@input.pdf \ -F maximum_bytes=1048576 \ -o parts.zip ``` ```python title="Python" # pip install requests import requests with open('input.pdf', 'rb') as file: response = requests.post( 'https://api.pdfblocks.com/v1/split_by_size', headers={'X-API-Key': 'your_api_key'}, files={'file': file}, data={'maximum_bytes': 1048576}, # 1 MB ) response.raise_for_status() with open('parts.zip', 'wb') as output: output.write(response.content) ``` ```javascript title="Node.js" // Node.js 18+ import { readFile, writeFile } from 'node:fs/promises'; const body = new FormData(); body.set('file', new Blob([await readFile('input.pdf')]), 'input.pdf'); body.set('maximum_bytes', '1048576'); // 1 MB const response = await fetch('https://api.pdfblocks.com/v1/split_by_size', { method: 'POST', headers: { 'X-API-Key': 'your_api_key' }, body, }); if (!response.ok) throw new Error(`Request failed: ${response.status}`); await writeFile('parts.zip', Buffer.from(await response.arrayBuffer())); ``` ```php title="PHP" <?php $ch = curl_init('https://api.pdfblocks.com/v1/split_by_size'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['X-API-Key: your_api_key'], CURLOPT_POST => true, CURLOPT_POSTFIELDS => [ 'file' => new CURLFile('input.pdf', 'application/pdf'), 'maximum_bytes' => '1048576', // 1 MB ], ]); $zip = curl_exec($ch); if (curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200) { file_put_contents('parts.zip', $zip); } ``` ```ruby title="Ruby" # gem install http require 'http' response = HTTP .headers('X-API-Key' => 'your_api_key') .post('https://api.pdfblocks.com/v1/split_by_size', form: { file: HTTP::FormData::File.new('input.pdf'), maximum_bytes: '1048576', # 1 MB }) File.write('parts.zip', response.body) if response.status.success? ``` ```go title="Go" package main import ( "bytes" "io" "mime/multipart" "net/http" "os" ) func main() { var buf bytes.Buffer form := multipart.NewWriter(&buf) file, _ := os.Open("input.pdf") defer file.Close() part, _ := form.CreateFormFile("file", "input.pdf") io.Copy(part, file) form.WriteField("maximum_bytes", "1048576") // 1 MB form.Close() req, _ := http.NewRequest("POST", "https://api.pdfblocks.com/v1/split_by_size", &buf) req.Header.Set("Content-Type", form.FormDataContentType()) req.Header.Set("X-API-Key", "your_api_key") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() out, _ := os.Create("parts.zip") defer out.Close() io.Copy(out, res.Body) } ``` ```csharp title="C#" using var client = new HttpClient(); client.DefaultRequestHeaders.Add("X-API-Key", "your_api_key"); using var form = new MultipartFormDataContent { { new ByteArrayContent(File.ReadAllBytes("input.pdf")), "file", "input.pdf" }, { new StringContent("1048576"), "maximum_bytes" }, // 1 MB }; var response = await client.PostAsync( "https://api.pdfblocks.com/v1/split_by_size", form); response.EnsureSuccessStatusCode(); await File.WriteAllBytesAsync( "parts.zip", await response.Content.ReadAsByteArrayAsync()); ``` </CodeGroup> ## レスポンス このアクションは複数のドキュメントを返し、`Accept` リクエストヘッダーに応じて1つのレスポンスにまとめられます。ネゴシエーションの完全なリファレンスについては [レスポンスフォーマットとコンテンツネゴシエーション](/docs/api/response-formats) を参照してください。`Accept` ヘッダーがない場合、デフォルトは ZIP アーカイブです。 ```http HTTP/1.1 200 OK Content-Type: application/zip ``` `Accept` ヘッダーで梱包形式を選択します。 | `Accept` ヘッダー | レスポンス | | --- | --- | | *(送信なし)* | `application/zip`（デフォルト） | | `application/zip` | 出力 PDF の ZIP アーカイブ | | `application/json` | base64 エンコードされたドキュメントの JSON エンベロープ | | `multipart/mixed` | パートごとに1つの PDF | | それ以外 | `406 Not Acceptable` | 出力ドキュメントは順に `00001.pdf`、`00002.pdf` のように名付けられます。 <Note> 各パートは、レンダリングされた出力サイズが `maximum_bytes` をわずかに下回るように詰め込まれるため、上限に近づきますが超えることはありません。例外は、ページ単体のサイズがすでに `maximum_bytes` を超えている場合です。ページはそれ以上分割されないため、上限を超えたまま単独のパートとして返されます。 </Note> <Tip> 分割アクションを呼び出し、各フォーマット（ZIP の展開、JSON エンベロープのデコード、multipart パートの読み取り）を扱うエンドツーエンドのコードは、[PDF を分割して出力を扱う](/docs/api/splitting-a-pdf) ガイドを参照してください。 </Tip> ## エラー 失敗したリクエストは `application/problem+json` 形式のボディを返します。このエンドポイントで最も多いのは `400` で、`maximum_bytes` が指定されていないか `1` 未満の場合、または `file` が読み取り可能な PDF でない場合に返されます。`errors` オブジェクトには各フィールド名が含まれます。 ```json { "type": "https://www.pdfblocks.com/docs/api/v1/error/400", "title": "One or more validation errors occurred.", "status": 400, "errors": { "maximum_bytes": ["The field maximum_bytes must be greater than or equal to 1."] } } ``` `Accept` ヘッダーが `application/zip`、`application/json`、`multipart/mixed` のいずれにも一致しない場合（例えば `Accept: application/pdf`）、API は `406 Not Acceptable` を返します。`Accept` を省略してデフォルトの ZIP を使うか、サポートされているメディアタイプのいずれかをリクエストしてください。`X-API-Key` が未指定または無効な場合は `401` が返されます。すべてのステータスコードとレスポンスの完全な形式については [エラー](/docs/api/errors) を参照してください。 ## 応用例 よくあるバリエーションです。展開するとすべての言語のコードが表示されます。 <AccordionGroup> <Accordion title="パートを JSON エンベロープとして受け取る"> `Accept: application/json` を送ると、すべてのパートが1つのレスポンスにインラインで含まれます。各エントリの `content` を base64 デコードし、`name` にちなんだファイル名で保存します。 <CodeGroup> ```bash title="cURL" curl https://api.pdfblocks.com/v1/split_by_size \ -H 'X-API-Key: your_api_key' \ -H 'Accept: application/json' \ -F file=@input.pdf \ -F maximum_bytes=1048576 \ | jq -r '.documents[] | .name + " " + .content' \ | while read -r name content; do echo "$content" | base64 --decode > "$name" done ``` ```python title="Python" # pip install requests import base64 import requests with open('input.pdf', 'rb') as file: response = requests.post( 'https://api.pdfblocks.com/v1/split_by_size', headers={ 'X-API-Key': 'your_api_key', 'Accept': 'application/json', }, files={'file': file}, data={'maximum_bytes': 1048576}, ) response.raise_for_status() for document in response.json()['documents']: with open(document['name'], 'wb') as output: output.write(base64.b64decode(document['content'])) ``` ```javascript title="Node.js" // Node.js 18+ import { readFile, writeFile } from 'node:fs/promises'; const body = new FormData(); body.set('file', new Blob([await readFile('input.pdf')]), 'input.pdf'); body.set('maximum_bytes', '1048576'); const response = await fetch('https://api.pdfblocks.com/v1/split_by_size', { method: 'POST', headers: { 'X-API-Key': 'your_api_key', Accept: 'application/json' }, body, }); if (!response.ok) throw new Error(`Request failed: ${response.status}`); const { documents } = await response.json(); for (const doc of documents) { await writeFile(doc.name, Buffer.from(doc.content, 'base64')); } ``` ```php title="PHP" <?php $ch = curl_init('https://api.pdfblocks.com/v1/split_by_size'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'X-API-Key: your_api_key', 'Accept: application/json', ], CURLOPT_POST => true, CURLOPT_POSTFIELDS => [ 'file' => new CURLFile('input.pdf', 'application/pdf'), 'maximum_bytes' => '1048576', ], ]); $body = curl_exec($ch); if (curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200) { foreach (json_decode($body, true)['documents'] as $document) { file_put_contents($document['name'], base64_decode($document['content'])); } } ``` ```ruby title="Ruby" # gem install http require 'base64' require 'http' require 'json' response = HTTP .headers('X-API-Key' => 'your_api_key', 'Accept' => 'application/json') .post('https://api.pdfblocks.com/v1/split_by_size', form: { file: HTTP::FormData::File.new('input.pdf'), maximum_bytes: '1048576', }) if response.status.success? JSON.parse(response.body)['documents'].each do |document| File.write(document['name'], Base64.decode64(document['content'])) end end ``` ```go title="Go" package main import ( "bytes" "encoding/base64" "encoding/json" "io" "mime/multipart" "net/http" "os" ) func main() { var buf bytes.Buffer form := multipart.NewWriter(&buf) file, _ := os.Open("input.pdf") defer file.Close() part, _ := form.CreateFormFile("file", "input.pdf") io.Copy(part, file) form.WriteField("maximum_bytes", "1048576") form.Close() req, _ := http.NewRequest("POST", "https://api.pdfblocks.com/v1/split_by_size", &buf) req.Header.Set("Content-Type", form.FormDataContentType()) req.Header.Set("X-API-Key", "your_api_key") req.Header.Set("Accept", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() var result struct { Documents []struct { Name string `json:"name"` Content string `json:"content"` } `json:"documents"` } json.NewDecoder(res.Body).Decode(&result) for _, doc := range result.Documents { data, _ := base64.StdEncoding.DecodeString(doc.Content) os.WriteFile(doc.Name, data, 0644) } } ``` ```csharp title="C#" using System.Text.Json; using var client = new HttpClient(); client.DefaultRequestHeaders.Add("X-API-Key", "your_api_key"); client.DefaultRequestHeaders.Add("Accept", "application/json"); using var form = new MultipartFormDataContent { { new ByteArrayContent(File.ReadAllBytes("input.pdf")), "file", "input.pdf" }, { new StringContent("1048576"), "maximum_bytes" }, }; var response = await client.PostAsync( "https://api.pdfblocks.com/v1/split_by_size", form); response.EnsureSuccessStatusCode(); using var json = JsonDocument.Parse( await response.Content.ReadAsStringAsync()); foreach (var document in json.RootElement.GetProperty("documents").EnumerateArray()) { var name = document.GetProperty("name").GetString()!; var content = document.GetProperty("content").GetString()!; await File.WriteAllBytesAsync(name, Convert.FromBase64String(content)); } ``` </CodeGroup> </Accordion> </AccordionGroup> ## 関連アクション <CardGroup cols={2}> <Card title="ページ数で分割する" href="/docs/api/split-pdf-by-page-count"> バイト数ではなくページ数で分割します。 </Card> <Card title="指定したページで分割する" href="/docs/api/split-pdf-at-page"> 境界で2つのドキュメントに分割します。 </Card> <Card title="ページグループで分割する" href="/docs/api/split-pdf-into-page-groups"> 任意のページグループを手動で定義します。 </Card> <Card title="ページを抽出する" href="/docs/api/extract-pages-from-pdf"> 1つのページ範囲だけを残します。 </Card> </CardGroup>