PDF Multi-Tool
Ensambla un PDF a partir de un plan de páginas explícito: reordena, duplica, rota o elimina páginas, y extrae páginas de PDFs adicionales, todo en una sola solicitud.
API Endpoint
POST /api/v1/tools/pdf/multi-tool-pdf
Acepta datos de formulario multipart con uno o más archivos PDF y un campo JSON settings. Se admiten hasta 20 documentos de entrada y 1.200 páginas de salida por solicitud.
Parameters
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| items | array | Sí | Plan de páginas de salida, en orden de salida. Cada elemento es { "doc": <int>, "page": <int>, "rot": <90|180|270, optional> }. doc indexa los archivos subidos en orden de subida (base 0); page es un número de página base 1 en ese documento. |
| pageCounts | array | Sí | Número real de páginas de cada documento subido, en el mismo orden. Una página del plan que supere el número de páginas de su documento se rechaza con 400. |
Example Request
Toma las páginas 3 y 1 del primer documento y las páginas 1 y 2 del segundo, rotando la primera página de salida 90° en sentido horario:
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]}'Example Response
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 misma página puede aparecer varias veces en
itemspara duplicarla. - Las páginas ausentes de
itemsse omiten de la salida. rotregistra la nueva orientación de visualización en la página copiada (compuesta con cualquier rotación existente); el contenido de la página no se modifica.- La rotación se aplica por cada copia de salida, por lo que los duplicados pueden tener rotaciones distintas.
- La salida es un documento nuevo y plano; no se conservan los marcadores ni los metadatos a nivel de documento de origen.
- El procesamiento requiere el binario qpdf, que se incluye en la imagen Docker oficial.
