API de PDF: unir, dividir, girar y comprimir
Une varios PDF, extrae páginas, y gira y comprime PDF en la nube con un solo endpoint.
Respuesta breve
Envía POST /api/v1/pdf-job/ con una operation merge, split, rotate o compress. Pasa sourceKeys (en orden) para merge, o un único sourceKey para las demás; split recibe en "pages" números de página contados desde cero y rotate recibe "degrees" de 90, 180 o 270. Los archivos provienen de una subida directa y el resultado es un nuevo trabajo PDF que consultas como cualquier otro.
Operaciones
Los archivos ya deben estar en el almacenamiento de tu cuenta: súbelos primero y usa los valores objectKey devueltos.
| operation | Entrada | Campos adicionales |
|---|---|---|
| merge | sourceKeys: 2 o más PDF, en orden | — |
| split | sourceKey | pages: array contado desde cero; p. ej., [0, 1, 4] conserva las páginas 1, 2 y 5 |
| rotate | sourceKey | degrees: 90, 180 o 270 |
| compress | sourceKey | — (perfil "ebook" de Ghostscript, imágenes a 150 dpi) |
Une dos PDF subidos
Para unir PDF que ya están en línea, envía POST /api/v1/merge/ con un array "files" de 2–20 URL de PDF en orden. Cuesta 1 crédito y devuelve el PDF unido directamente en la respuesta en lugar de un trabajo, lo que resulta práctico en herramientas sin código.
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"] }'Límites y comportamiento
Cada entrada puede ocupar hasta 100 MB y un trabajo hasta 150 MB en total. La compresión reescribe las imágenes a unos 150 dpi, lo que va bien para correo electrónico y subidas; los PDF de texto que ya son pequeños pueden no reducirse mucho. Los PDF cifrados deben desbloquearse primero.
Preguntas frecuentes
¿Los números de página empiezan en cero?
En la API, sí: [0] es la primera página. Las herramientas del sitio web numeran a partir de 1.
¿Puedo comprimir a un tamaño exacto?
No con este endpoint. Aplica un único perfil equilibrado; para objetivos exactos, el sitio web tiene una herramienta de compresión a un tamaño concreto.