Split PDF API & SDK
Divide documentos con control de precisiónTransforma tus flujos de documentos con división de PDF de precisión
La API y el SDK de división de PDF proporcionan a los desarrolladores capacidades sólidas para dividir documentos PDF en varios archivos más pequeños según páginas o rangos específicos. Esta tecnología permite la extracción precisa de secciones del documento, ya sea para separar capítulos, eliminar contenido confidencial o crear archivos más manejables para su distribución.
Construida para integrarse en aplicaciones de escritorio, servicios web y flujos de trabajo de documentos automatizados, nuestra solución mantiene la integridad del documento mientras brinda control total sobre la selección y organización de páginas. El modelo de procesamiento asíncrono de la API gestiona documentos de hasta 10 MB de forma eficiente, por lo que es adecuada tanto para procesamiento individual como para operaciones por lotes de gran volumen.
A diferencia de las bibliotecas PDF genéricas que ofrecen una funcionalidad limitada de división, nuestra API y SDK dedicados ofrecen control granular sobre el proceso con una complejidad de implementación mínima, permitiéndote centrarte en la lógica principal de tu aplicación en lugar de la manipulación de PDF.
Características técnicas clave
Motor flexible de selección de páginas
El motor de selección acepta números de página separados por comas y rangos con guiones (por ejemplo, "1,3,5‑8,10"), dándote un control preciso sobre qué páginas extraer. Las páginas pueden especificarse en cualquier orden y aparecerán en ese mismo orden en los documentos resultantes. Cuando no se proporciona selección de páginas, el motor genera automáticamente archivos PDF independientes para cada página del documento original.
POST/pdf-split/v1
Content-Type:multipart/form-data
...
file: [binaryPDFdata]
pages:"1,3,5-8,10"Arquitectura de procesamiento asíncrono
Nuestra API implementa un modelo de procesamiento asíncrono, devolviendo un ID de operación inmediatamente mientras el procesamiento continúa en segundo plano. Esta arquitectura evita tiempos de espera en documentos grandes y permite que tu aplicación maneje varias operaciones de división simultáneamente sin bloquear la interacción del usuario.
{
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Status checking is handled through a separate endpoint:
GET/operation/v1/{operationId}/status
Etiquetado personalizado de salida
Controla la convención de nombres de tus documentos divididos con el parámetro labelStart. El formato de nombres sigue '{nombreDelDocumentoOriginal}.pdf - númeroEtiqueta', donde númeroEtiqueta comienza en el valor especificado (predeterminado 0) y aumenta en 1 para cada archivo subsiguiente. Esta función simplifica la organización y el seguimiento de documentos en flujos de trabajo con múltiples archivos.
POST /pdf-split/v1
Content-Type: multipart/form-data
file: [binaryPDFdata]
pages: "1-5,10-15,20-25"
labelStart: 100
Soporte para documentos protegidos con contraseña
La API procesa PDFs protegidos mediante el parámetro password en la solicitud. Esto permite a tu aplicación manejar documentos protegidos sin que los usuarios tengan que eliminar la protección previamente, manteniendo la seguridad durante todo el flujo.
POST/pdf-split/v1
Content-Type: multipart/form-data
file: [binaryPDFdata]
password: "document_password"
pages: "1-10"
Enfoques de implementación
Implementación SDK
Para aplicaciones de escritorio y servidores que requieran integración más profunda, nuestro SDK proporciona la misma funcionalidad con menor sobrecarga de red y acceso directo al sistema de archivos, ideal para procesamiento de documentos de alto volumen.
Integración de API RESTful
Integra la funcionalidad de división de PDF directamente en tus aplicaciones con nuestra API RESTful. La estructura de endpoints y el formato multipart/form-data la hacen compatible con cualquier lenguaje o framework que soporte solicitudes HTTP.
Sample Python Implementation:
import requests
url = "https://api.example.com/pdf-split/v1"
files = {"file": open("document.pdf", "rb")}
data = {"pages": "1-5,10,15-20", "labelStart": 1}
response = requests.post(url, files=files, data=data)
operation = response.json()
# Check operation status
status_url = "https://api.example.com/operation/v1/{operation['id']}/status"
status_response = requests.get(status_url)
Capacidades PDF complementarias
Recombinación de documentos
Complementa las operaciones de división con nuestra funcionalidad de combinación (Merge) para recomponer documentos según sea necesario, permitiendo escenarios avanzados donde el contenido se separa y luego se recompone selectivamente.
Opciones de compresión
Para aplicaciones en las que el tamaño del archivo es crítico, se pueden aplicar nuestras capacidades de compresión antes o después de la división, disponibles en la API y el SDK para equilibrar tamaño y calidad.
Preguntas frecuentes técnicas
¿Cuál es el tamaño máximo de archivo admitido?
La API admite archivos PDF de hasta 10 MB. Para archivos mayores, considera usar el SDK o dividir la operación.
¿Cómo se manejan los archivos protegidos por contraseña?
Los archivos protegidos requieren que el parámetro password se incluya en la solicitud; la contraseña solo se usa para acceder al documento y no se almacena.
¿Puedo extraer páginas específicas?
Sí. El parámetro pages acepta números y rangos en cualquier orden, permitiendo una extracción precisa del contenido deseado.
¿Se verá afectada la calidad después de la extracción?
No. Nuestra tecnología de preservación de formato mantiene la calidad, el diseño y los elementos interactivos originales.
¿Cómo puedo monitorear el estado de las operaciones?
Cada operación devuelve un ID que puede usarse con el endpoint de estado para comprobar el progreso y descargar los resultados cuando estén listos.