Resize PDF API y SDK
Control programático de las dimensiones de los documentosPotente control de dimensiones de documentos al alcance de tu mano
La Resize PDF API proporciona a los desarrolladores control programático sobre las dimensiones de los documentos PDF, permitiendo ajustes precisos que cumplen requisitos de salida específicos. Esta API está pensada para los equipos de desarrollo que necesitan capacidades sólidas de redimensionado de PDF en sus aplicaciones, flujos de trabajo o sistemas de gestión documental.
Ya sea que construyas pipelines de procesamiento, plataformas de publicación o soluciones de gestión empresarial, nuestra API ofrece los cimientos técnicos para implementar redimensionado personalizado con un mínimo de código. Mantiene la claridad y el formato del documento, mientras proporciona control granular sobre dimensiones, márgenes y selección de páginas.
A diferencia de las bibliotecas PDF genéricas, que exigen una configuración extensa, o de las soluciones en la nube con personalización limitada, nuestra Resize PDF API ofrece una solución enfocada y de alto rendimiento para la manipulación de dimensiones con resultados predecibles en todos los tipos de documento.
Características técnicas y capacidades
Control de dimensiones con precisión decimal
Define dimensiones exactas con precisión decimal entre 0.1 y 200 pulgadas para ancho y alto. El valor predeterminado es A4 (8.3 × 11.7 pulgadas), pero acepta valores personalizados para adaptarse a cualquier requisito, desde formatos de impresora específicos hasta plantillas digitales estándar.
width: number($float)
The width in inches. Value range: 0.1-200 inches. Default: 8.3 inches
height: number($float)
The height in inches. Value range: 0.1-200 inches. Default: 11.7 inchesProcesamiento selectivo de páginas
Procese páginas específicas dentro de documentos de varias páginas definiendo rangos de páginas exactos y páginas individuales. La API admite números de página separados por comas y rangos con guion (p. ej., "1,3,5-7"), lo que le proporciona un control preciso sobre qué páginas cambiar de tamaño. Este enfoque específico es especialmente valioso cuando se trabaja con documentos en los que solo algunas secciones requieren ajustes de dimensiones.
pages: string
Format examples:"1,3,5"or"1-3,7"or"1,3-5,7-9"
Pages appear in ascending order in the output regardless of input order
Soporte de documentos protegidos con contraseña
Procese sin problemas los PDF protegidos proporcionando la contraseña del documento como parámetro. Esta función elimina las interrupciones en el flujo de trabajo al manejar documentos protegidos y mantiene los protocolos de seguridad en toda la cadena de procesamiento. La API gestiona la autenticación de forma transparente, lo que permite que su aplicación mantenga un procesamiento continuo de los documentos.
password: string
The password to open the protected PDF file
Arquitectura de procesamiento asíncrono
La API implementa un modelo de procesamiento asíncrono, que devuelve un ID de operación inmediatamente mientras el procesamiento continúa en segundo plano. Esta arquitectura evita las operaciones de bloqueo y permite el manejo eficiente de documentos más grandes. Supervise el estado de la operación a través del punto final /operation/v1/{operationId}/status para determinar cuándo se ha completado el procesamiento.
{
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Guía de implementación
Integración RESTful API
La API de cambio de tamaño de PDF sigue los principios RESTful con una estructura de punto final sencilla:
La API acepta multipart/form-data con los siguientes parámetros:
file: El archivo PDF al que se le va a cambiar el tamaño (binario, máx. 10 MB)
password: Contraseña opcional para documentos protegidos
pages: Selección de página opcional (p. ej., "1,3,5-7")
width: Ancho opcional en pulgadas (0,1-200, predeterminado 8,3)
height: Alto opcional en pulgadas (0,1-200, predeterminado 11,7)
Los códigos de respuesta proporcionan información de estado clara:
202: Éxito, devuelve el ID de la operación
400: Parámetros de solicitud no válidos
401: Fallo de autenticación
413: El archivo supera el límite de tamaño
Implementación SDK
Para los desarrolladores que prefieren la integración directa de la biblioteca en lugar de las llamadas a la API, nuestro SDK proporciona la misma funcionalidad con enlaces de lenguaje nativo. El SDK ofrece ventajas adicionales, entre las que se incluyen:
- Reducción de la sobrecarga de la red para el procesamiento de grandes volúmenes
- Supervisión del progreso para operaciones de larga duración
- Manejo de errores y lógica de reintentos simplificados
- Comportamiento coherente en todas las plataformas
- Validación automática de parámetros
¿Sabía que...?
Los márgenes no son un invento moderno. ¡Incluso nuestros antepasados utilizaban los márgenes para dar formato a sus textos! Los márgenes se utilizaron por primera vez en los antiguos rollos de papiro egipcios. Como los rollos se desenrollaban horizontalmente, las columnas de texto estaban separadas por márgenes para indicar al lector cuándo debía pasar a la línea siguiente.
Ventajas técnicas
Comparación entre SDK y SaaS
Capacidades PDF complementarias
Compresión de PDF
Combine el cambio de tamaño con la compresión para reducir aún más el tamaño del archivo y, al mismo tiempo, mantener la calidad del documento. Nuestras herramientas de compresión reducen de forma inteligente el tamaño de los archivos PDF optimizando las estructuras internas, eliminando las redundancias y aplicando algoritmos de compresión basados en el contenido. Esta combinación es especialmente eficaz para preparar documentos para su distribución en la web o su transmisión por correo electrónico.
Conversión de formatos
Transforme documentos entre PDF y otros formatos como parte de su flujo de trabajo de documentos. Nuestras herramientas de conversión admiten la transformación bidireccional entre los formatos PDF y Microsoft Office (Word, Excel, PowerPoint), así como los formatos de imagen más comunes. Esta capacidad permite crear canalizaciones completas de procesamiento de documentos que pueden aceptar múltiples formatos de entrada y producir una salida estandarizada.
Preguntas frecuentes
¿Cómo cambio las dimensiones de mi PDF?
Después de cargar su PDF a través de la API, especifique las nuevas dimensiones utilizando los parámetros de ancho y alto (en pulgadas). La API cambiará el tamaño del documento de acuerdo con estas especificaciones, manteniendo la calidad y el formato del contenido.
¿Cómo reduzco el tamaño de un PDF manteniendo la calidad?
La API de cambio de tamaño de PDF adapta las dimensiones de su PDF al tiempo que preserva la calidad de las imágenes, las fuentes y otros contenidos. Para reducir el tamaño de los archivos, combine el ajuste de las dimensiones con nuestra API de compresión de PDF, que reduce el tamaño real del archivo mediante técnicas de compresión basadas en el contenido.
¿Es seguro redimensionar PDFs con la API?
Priorizamos la seguridad de los documentos en toda la cadena de procesamiento. Todos los archivos se procesan en entornos aislados, se transmiten mediante protocolos seguros y se eliminan automáticamente después del procesamiento. Para obtener la máxima seguridad, considere la opción de implementación del SDK, que mantiene todos los documentos dentro de su infraestructura.
Es posible que se apliquen limitaciones de tamaño y de uso diario en función de su nivel de servicio.