PDF Multi-Tool
Assembler un PDF à partir d'un plan de pages explicite : réorganiser, dupliquer, faire pivoter ou supprimer des pages, et récupérer des pages d'autres PDF, le tout en une seule requête.
Point de terminaison de l'API
POST /api/v1/tools/pdf/multi-tool-pdf
Accepte des données de formulaire multipart avec un ou plusieurs fichiers PDF et un champ JSON settings. Jusqu'à 20 documents d'entrée et 1 200 pages de sortie sont pris en charge par requête.
Paramètres
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| items | array | Oui | Plan de pages de sortie, dans l'ordre de sortie. Chaque élément est { "doc": <int>, "page": <int>, "rot": <90|180|270, optional> }. doc indexe les fichiers téléversés dans l'ordre de téléversement (base 0) ; page est un numéro de page base 1 dans ce document. |
| pageCounts | array | Oui | Nombre réel de pages de chaque document téléversé, dans le même ordre. Une page du plan au-delà du nombre de pages de son document est rejetée avec une erreur 400. |
Exemple de requête
Prendre les pages 3 et 1 du premier document, puis les pages 1 et 2 du second, en faisant pivoter la première page de sortie de 90° dans le sens horaire :
bash
curl -X POST http://localhost:1349/api/v1/tools/pdf/multi-tool-pdf \
-H "Authorization: Bearer si_your-api-key" \
-F "[email protected]" \
-F "[email protected]" \
-F 'settings={"items":[{"doc":0,"page":3,"rot":90},{"doc":0,"page":1},{"doc":1,"page":1},{"doc":1,"page":2}],"pageCounts":[3,2]}'Exemple de réponse
json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/document_multi-tool.pdf",
"originalSize": 2450000,
"processedSize": 2450000
}Notes
- La même page peut apparaître plusieurs fois dans
itemspour la dupliquer. - Les pages absentes de
itemssont omises de la sortie. rotenregistre la nouvelle orientation d'affichage sur la page copiée (composée avec toute rotation existante) ; le contenu de la page n'est pas modifié.- La rotation est appliquée par copie de sortie, de sorte que les doublons peuvent avoir des rotations différentes.
- La sortie est un document nouveau et plat ; les signets source et les métadonnées au niveau du document ne sont pas conservés.
- Le traitement nécessite le binaire qpdf, fourni dans l'image Docker officielle.
