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.
| operation | Entrée | Champs supplémentaires |
|---|---|---|
| merge | sourceKeys : 2 PDF ou plus, dans l’ordre | — |
| split | sourceKey | pages : tableau d’indices commençant à zéro ; par exemple, [0, 1, 4] conserve les pages 1, 2 et 5 |
| rotate | sourceKey | degrees : 90, 180 ou 270 |
| compress | sourceKey | — (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.