PDF Blocks
PreiseSupport
Kostenlos starten
Seite öffnen

Ein PDF in Seitengruppen aufteilen

Teilen Sie ein PDF in Seitengruppen auf, die Sie selbst festlegen, wobei jede Gruppe zu einem Ausgabedokument wird.

Teilen Sie ein PDF-Dokument in Seitengruppen auf, die Sie selbst festlegen: Jede Gruppe wird zu einem Ausgabe-PDF, in der Reihenfolge, in der die Gruppen geschrieben sind. Innerhalb einer Gruppe folgen Seiten und Bereiche der geordneten Seitensyntax, sie kommen also genau so heraus, wie sie aufgeführt sind. Diese Aktion gibt mehrere Dokumente zurück, verpackt in eine einzige Antwort gemäß dem Header Accept. Die API ist stateless: Ihr Dokument wird in der Region verarbeitet und niemals gespeichert.

Endpoint

POST
/v1/split_by_groups

In allen Regionen verfügbar. Hinweise zu Routing und Datenresidenz finden Sie unter Regionen und Datenresidenz.

Region URL
Global https://api.pdfblocks.com/v1/split_by_groups
USA https://us.api.pdfblocks.com/v1/split_by_groups
HIPAA USA https://hipaa.api.pdfblocks.com/v1/split_by_groups
Europäische Union https://eu.api.pdfblocks.com/v1/split_by_groups
Vereinigtes Königreich https://uk.api.pdfblocks.com/v1/split_by_groups
Kanada https://ca.api.pdfblocks.com/v1/split_by_groups
Australien https://au.api.pdfblocks.com/v1/split_by_groups
Japan https://jp.api.pdfblocks.com/v1/split_by_groups
Indien https://in.api.pdfblocks.com/v1/split_by_groups
Brasilien https://br.api.pdfblocks.com/v1/split_by_groups

Authentifizierung

Authentifizieren Sie jede Anfrage mit Ihrem geheimen API-Schlüssel im Header X-API-Key, über HTTPS. Schlüssel erstellen und verwalten Sie im Dashboard. Einzelheiten finden Sie unter Authentifizierung.

Anfrage

Der Endpoint nimmt einen Anfragetext vom Typ multipart/form-data entgegen.

filefilerequired

Das PDF-Eingabedokument.

groupsstringrequired

Die zu erzeugenden Seitengruppen, geschrieben in der Syntax für Seitengruppen. Gruppen werden durch ; getrennt; innerhalb einer Gruppe werden Seiten und Bereiche durch , getrennt und folgen den geordneten Regeln. Jede Gruppe wird zu einem Ausgabe-PDF, in der Reihenfolge, in der die Gruppen geschrieben sind. Zum Beispiel erzeugt 2..8,29;1 zwei PDFs: die Seiten 2 bis 8 und dann 29 sowie die Seite 1.

Seitengruppen

Gruppen werden durch ; getrennt. Innerhalb jeder Gruppe folgen Seiten und Bereiche der geordneten Syntax: Reihenfolge und Wiederholungen zählen, eine zweimal genannte Seite wird zweimal ausgegeben, und ein Bereich darf rückwärts laufen. Jede Gruppe wird zu einem Ausgabe-PDF, ausgegeben in der Reihenfolge, in der die Gruppen geschrieben sind.

Zum Beispiel erzeugt 2..8,29;1 zwei Dokumente:

Gruppe Ausgabe-PDF Seiten
2..8,29 00001.pdf Die Seiten 2, 3, 4, 5, 6, 7, 8, dann 29
1 00002.pdf Die Seite 1

Innerhalb einer Gruppe gilt für groups dieselbe geordnete Semantik wie für page_order. Siehe Seiten auswählen für die vollständige Referenz.

Beispiele

Teilen Sie ein Dokument in zwei PDFs auf: die Seiten 2 bis 8 und dann 29 sowie die Seite 1:

cURLbash
curl https://api.pdfblocks.com/v1/split_by_groups \
  -H 'X-API-Key: your_api_key' \
  -F file=@input.pdf \
  -F groups='2..8,29;1' \
  -o parts.zip
Pythonpython
# pip install requests
import requests

with open('input.pdf', 'rb') as file:
    response = requests.post(
        'https://api.pdfblocks.com/v1/split_by_groups',
        headers={'X-API-Key': 'your_api_key'},
        files={'file': file},
        data={'groups': '2..8,29;1'},
    )

response.raise_for_status()
with open('parts.zip', 'wb') as output:
    output.write(response.content)
Node.jsjavascript
// 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('groups', '2..8,29;1');

const response = await fetch('https://api.pdfblocks.com/v1/split_by_groups', {
  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()));
PHPphp
<?php
$ch = curl_init('https://api.pdfblocks.com/v1/split_by_groups');
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'),
        'groups' => '2..8,29;1',
    ],
]);

$zip = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200) {
    file_put_contents('parts.zip', $zip);
}
Rubyruby
# gem install http
require 'http'

response = HTTP
  .headers('X-API-Key' => 'your_api_key')
  .post('https://api.pdfblocks.com/v1/split_by_groups', form: {
    file: HTTP::FormData::File.new('input.pdf'),
    groups: '2..8,29;1',
  })

File.write('parts.zip', response.body) if response.status.success?
Gogo
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("groups", "2..8,29;1")
	form.Close()

	req, _ := http.NewRequest("POST", "https://api.pdfblocks.com/v1/split_by_groups", &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)
}
C#csharp
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("2..8,29;1"), "groups" },
};

var response = await client.PostAsync(
    "https://api.pdfblocks.com/v1/split_by_groups", form);
response.EnsureSuccessStatusCode();
await File.WriteAllBytesAsync(
    "parts.zip", await response.Content.ReadAsByteArrayAsync());

Antwort

Diese Aktion gibt mehrere Dokumente zurück, verpackt in eine einzige Antwort gemäß dem Anfrage-Header Accept. Siehe Antwortformate und Inhaltsaushandlung für die vollständige Referenz zur Aushandlung. Ohne den Header Accept ist ein ZIP-Archiv die Voreinstellung:

HTTP/1.1 200 OK
Content-Type: application/zip

Wählen Sie die Verpackung über den Header Accept:

Header Accept Antwort
(nicht gesendet) application/zip, die Voreinstellung
application/zip Ein ZIP-Archiv der Ausgabe-PDFs
application/json Ein JSON-Umschlag mit base64-kodierten Dokumenten
multipart/mixed Ein PDF pro Teil
alles andere 406 Not Acceptable

Die API erzeugt ein Ausgabedokument pro Gruppe, in der Reihenfolge, in der die Gruppen geschrieben sind, benannt als 00001.pdf, 00002.pdf und so weiter.

Vollständigen Code, der eine Aktion zum Aufteilen aufruft und jedes Format entpackt (das ZIP extrahieren, den JSON-Umschlag dekodieren oder die Multipart-Teile lesen), finden Sie im Leitfaden Ein PDF aufteilen.

Fehler

Fehlgeschlagene Anfragen geben einen Text vom Typ application/problem+json zurück. Der häufigste Fehler an diesem Endpoint ist 400, der zurückgegeben wird, wenn groups fehlt oder fehlerhaft ist oder wenn der Parameter auf eine Seite verweist, die es im Dokument nicht gibt. Das Objekt errors benennt jedes Feld:

{
  "type": "https://www.pdfblocks.com/docs/api/v1/error/400",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "errors": {
    "groups": ["The groups field references a page that does not exist in the document."]
  }
}

Wenn der Header Accept keinem der Typen application/zip, application/json oder multipart/mixed entspricht (zum Beispiel Accept: application/pdf), antwortet die API mit 406 Not Acceptable. Lassen Sie Accept weg, um die ZIP-Voreinstellung zu erhalten, oder fordern Sie einen der unterstützten Medientypen an. Ein fehlender oder ungültiger X-API-Key gibt einen 401 zurück. Alle Statuscodes und die vollständige Form der Antwort finden Sie unter Fehler.

Rezepte

Eine häufige Variante. Klappen Sie sie auf, um den Code in allen Sprachen zu sehen.

Die Teile als JSON-Umschlag empfangen

Senden Sie Accept: application/json, um alle Teile inline in einer einzigen Antwort zu erhalten, und dekodieren Sie dann den content jedes Eintrags aus Base64 in eine Datei, die nach seinem name benannt ist:

cURLbash
curl https://api.pdfblocks.com/v1/split_by_groups \
  -H 'X-API-Key: your_api_key' \
  -H 'Accept: application/json' \
  -F file=@input.pdf \
  -F groups='2..8,29;1' \
  | jq -r '.documents[] | .name + " " + .content' \
  | while read -r name content; do
      echo "$content" | base64 --decode > "$name"
    done
Pythonpython
# pip install requests
import base64
import requests

with open('input.pdf', 'rb') as file:
    response = requests.post(
        'https://api.pdfblocks.com/v1/split_by_groups',
        headers={
            'X-API-Key': 'your_api_key',
            'Accept': 'application/json',
        },
        files={'file': file},
        data={'groups': '2..8,29;1'},
    )

response.raise_for_status()
for document in response.json()['documents']:
    with open(document['name'], 'wb') as output:
        output.write(base64.b64decode(document['content']))
Node.jsjavascript
// 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('groups', '2..8,29;1');

const response = await fetch('https://api.pdfblocks.com/v1/split_by_groups', {
  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'));
}
PHPphp
<?php
$ch = curl_init('https://api.pdfblocks.com/v1/split_by_groups');
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'),
        'groups' => '2..8,29;1',
    ],
]);

$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']));
    }
}
Rubyruby
# 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_groups', form: {
    file: HTTP::FormData::File.new('input.pdf'),
    groups: '2..8,29;1',
  })

if response.status.success?
  JSON.parse(response.body)['documents'].each do |document|
    File.write(document['name'], Base64.decode64(document['content']))
  end
end
Gogo
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("groups", "2..8,29;1")
	form.Close()

	req, _ := http.NewRequest("POST", "https://api.pdfblocks.com/v1/split_by_groups", &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)
	}
}
C#csharp
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("2..8,29;1"), "groups" },
};

var response = await client.PostAsync(
    "https://api.pdfblocks.com/v1/split_by_groups", 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));
}

Verwandte Aktionen

Nach Seitenanzahl aufteilen

In Blöcke fester Größe aufteilen.

An einer Seite aufteilen

An einer Trennstelle in zwei Dokumente aufteilen.

Seiten neu anordnen

Seiten innerhalb einer einzigen Ausgabe neu anordnen.

Seiten extrahieren

Einen Seitenbereich behalten.