Aller au contenu principal

Trouvez votre prochain outil

Documentation/API/API PDF : fusionner, scinder, tourner, compresser
API

API PDF : fusionner, scinder, tourner, compresser

Fusionnez plusieurs PDF, extrayez des pages, faites pivoter et compressez des PDF dans le cloud avec un seul endpoint.

Réponse courte

Envoyez POST /api/v1/pdf-job/ avec une operation parmi merge, split, rotate et compress. Transmettez sourceKeys (dans l’ordre) pour merge, ou un seul sourceKey pour les autres opérations ; split attend dans "pages" des numéros de page commençant à zéro, et rotate attend "degrees" valant 90, 180 ou 270. Les fichiers proviennent d’un envoi direct, et le résultat est une nouvelle tâche PDF que vous interrogez comme n’importe quelle autre.

Opérations

Les fichiers doivent déjà se trouver dans le stockage de votre compte : envoyez-les d’abord et utilisez les valeurs objectKey renvoyées.

operationEntréeChamps supplémentaires
mergesourceKeys : 2 PDF ou plus, dans l’ordre—
splitsourceKeypages : tableau d’indices commençant à zéro ; par exemple, [0, 1, 4] conserve les pages 1, 2 et 5
rotatesourceKeydegrees : 90, 180 ou 270
compresssourceKey— (profil Ghostscript "ebook", images à 150 dpi)

Fusionner deux PDF envoyés

Pour fusionner des PDF déjà en ligne, envoyez POST /api/v1/merge/ avec un tableau "files" de 2–20 URL de PDF dans l’ordre voulu. Cela coûte 1 crédit et renvoie directement le PDF fusionné dans la réponse au lieu d’une tâche, ce qui est pratique dans les outils sans code.

curl -X POST 'https://maxscanner.app/api/v1/pdf-job/' \
  -H "Authorization: Bearer $MAXSCANNER_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: pack-8812-merge' \
  -d '{ "operation": "merge", "filename": "pack.pdf", "sourceKeys": ["users/<id>/media/inbox/…-cover.pdf", "users/<id>/media/inbox/…-contract.pdf"] }'

Limites et comportement

Chaque fichier d’entrée peut atteindre 100 Mo, et une tâche 150 Mo au total. La compression réencode les images à environ 150 dpi, ce qui convient aux e-mails et aux envois en ligne ; un PDF de texte déjà léger risque de ne pas diminuer beaucoup. Les PDF chiffrés doivent d’abord être déverrouillés.

Questions fréquentes

Les numéros de page commencent-ils à zéro ?

Dans l’API, oui : [0] désigne la première page. Les outils du site utilisent une numérotation qui commence à 1.

Puis-je compresser jusqu’à une taille précise ?

Pas avec cet endpoint. Il applique un profil équilibré unique ; pour viser une taille exacte, le site propose un outil de compression à une taille cible.

Guides associés