Cette page a été traduite automatiquement. Vous avez repéré une erreur ?Aidez-nous à l'améliorer.
Skip to content

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ètreTypeRequisDescription
itemsarrayOuiPlan 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.
pageCountsarrayOuiNombre 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 items pour la dupliquer.
  • Les pages absentes de items sont omises de la sortie.
  • rot enregistre 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.