PDF Blocks
TarifsSupport
Commencer gratuitement
Ouvrir la page

Diviser un PDF en groupes de pages

Divisez un PDF en groupes de pages que vous définissez, où chaque groupe devient un document de sortie.

Divisez un document PDF en groupes de pages que vous définissez : chaque groupe devient un PDF de sortie, dans l’ordre d’écriture. Au sein d’un groupe, les pages et les plages suivent la syntaxe de pages ordonnée, de sorte qu’elles ressortent exactement telles qu’elles sont listées. Cette action renvoie plusieurs documents, empaquetés dans une seule réponse selon l’en-tête Accept. L’API est stateless : votre document est traité dans sa région et n’est jamais stocké.

Endpoint

POST
/v1/split_by_groups

Disponible dans toutes les régions. Voir Régions et résidence des données pour le routage et la résidence des données.

Région URL
Global https://api.pdfblocks.com/v1/split_by_groups
États-Unis https://us.api.pdfblocks.com/v1/split_by_groups
HIPAA États-Unis https://hipaa.api.pdfblocks.com/v1/split_by_groups
Union européenne https://eu.api.pdfblocks.com/v1/split_by_groups
Royaume-Uni https://uk.api.pdfblocks.com/v1/split_by_groups
Canada https://ca.api.pdfblocks.com/v1/split_by_groups
Australie https://au.api.pdfblocks.com/v1/split_by_groups
Japon https://jp.api.pdfblocks.com/v1/split_by_groups
Inde https://in.api.pdfblocks.com/v1/split_by_groups
Brésil https://br.api.pdfblocks.com/v1/split_by_groups

Authentification

Authentifiez chaque requête avec votre clé d’API secrète dans l’en-tête X-API-Key, en HTTPS. Créez et gérez vos clés depuis le dashboard. Voir Authentification pour le détail.

Requête

L’endpoint accepte un corps de requête multipart/form-data.

filefilerequired

Le document PDF d’entrée.

groupsstringrequired

Les groupes de pages à produire, selon la syntaxe des groupes de pages. Les groupes sont séparés par ;. Au sein d’un groupe, les pages et les plages sont séparées par , et suivent les règles ordonnées. Chaque groupe devient un PDF de sortie, dans l’ordre d’écriture. Par exemple, 2..8,29;1 produit deux PDF : les pages 2 à 8 puis la 29, et la page 1.

Groupes de pages

Les groupes sont séparés par ;. Au sein de chaque groupe, les pages et les plages suivent la syntaxe ordonnée : l’ordre et les répétitions comptent, une page nommée deux fois est émise deux fois, et une plage peut aller à rebours. Chaque groupe devient un PDF de sortie, émis dans l’ordre d’écriture des groupes.

Par exemple, 2..8,29;1 produit deux documents :

Groupe PDF de sortie Pages
2..8,29 00001.pdf Les pages 2, 3, 4, 5, 6, 7, 8, puis la 29
1 00002.pdf La page 1

Au sein d’un groupe, groups partage la sémantique ordonnée de page_order. Voir Sélectionner des pages pour la référence complète.

Exemples

Divisez un document en deux PDF : les pages 2 à 8 puis la 29, et la page 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());

Réponse

Cette action renvoie plusieurs documents, empaquetés dans une seule réponse selon l’en-tête de requête Accept : voir Formats de réponse et négociation de contenu pour la référence complète de la négociation. Sans en-tête Accept, une archive ZIP est renvoyée par défaut :

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

Sélectionnez l’empaquetage avec l’en-tête Accept :

En-tête Accept Réponse
(aucun envoyé) application/zip : la valeur par défaut
application/zip Une archive ZIP des PDF de sortie
application/json Une enveloppe JSON de documents encodés en base64
multipart/mixed Un PDF par partie
toute autre valeur 406 Not Acceptable

L’API produit un document de sortie par groupe, dans l’ordre d’écriture des groupes. Les documents sont nommés 00001.pdf, 00002.pdf, et ainsi de suite.

Pour du code de bout en bout qui appelle une action de division et dépaquette chaque format, qu’il s’agisse d’extraire le ZIP, de décoder l’enveloppe JSON ou de lire les parties multipart, voir le guide Diviser un PDF et traiter la sortie.

Erreurs

Les requêtes en échec renvoient un corps application/problem+json. La plus courante sur cet endpoint est une 400, renvoyée lorsque groups est absent ou mal formé, ou lorsqu’il référence une page qui n’existe pas dans le document : l’objet errors nomme chaque champ :

{
  "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."]
  }
}

Si l’en-tête Accept ne correspond à aucun des types application/zip, application/json ou multipart/mixed, par exemple Accept: application/pdf, l’API répond 406 Not Acceptable. Omettez Accept pour prendre le ZIP par défaut, ou demandez l’un des types de médias pris en charge. Une X-API-Key absente ou non valide renvoie une 401. Voir Erreurs pour tous les codes de statut et la forme complète de la réponse.

Recettes

Une variante courante. Dépliez-la pour la voir dans tous les langages.

Recevoir les parties dans une enveloppe JSON

Envoyez Accept: application/json pour obtenir toutes les parties en ligne dans une seule réponse, puis décodez en base64 le content de chaque entrée vers un fichier nommé d’après son name :

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));
}

Actions associées

Diviser par nombre de pages

Divisez en blocs de taille fixe.

Diviser à une page

Divisez en deux documents à un point de coupure.

Réorganiser les pages

Réorganisez les pages dans une seule sortie.

Extraire des pages

Conservez une plage de pages.