Watermark PDF API y SDK

Control seguro de documentos con superposiciones programables

Protección profesional de documentos y branding mediante código

La API Watermark PDF proporciona a los equipos de desarrollo una solución robusta para agregar marcas de agua personalizadas a documentos PDF de forma programática. Esta API RESTful permite a proveedores de software, ingenieros de automatización y desarrolladores integrar fácilmente capacidades de marca de agua en sus aplicaciones, servicios y flujos de trabajo de documentos.

Nuestra API gestiona la complejidad técnica del marcado de PDFs, ofreciendo al mismo tiempo un control detallado sobre todos los aspectos del proceso. Ya sea para aplicar avisos de confidencialidad en documentos corporativos, insertar logotipos en materiales dirigidos a clientes o marcar el estado del documento (BORRADOR, FINAL, etc.), nuestra solución ofrece resultados perfectos con un mínimo esfuerzo de integración.

A diferencia de las bibliotecas genéricas de PDF que requieren configuraciones extensas o de soluciones en la nube con opciones limitadas, nuestra Watermark PDF API ofrece rendimiento a nivel empresarial con una ruta de integración sencilla, compatible con procesamiento masivo por lotes y operaciones bajo demanda.

Características técnicas principales

Personalización completa de la marca de agua

La API proporciona control total sobre el aspecto y la colocación de las marcas de agua. Puedes definir propiedades tipográficas (familia, tamaño, color, peso, estilo), ajustar la opacidad de 0 a 1 y posicionar marcas con precisión a nivel de píxel. Admite múltiples ángulos de rotación (0°, 45°, 90°, 270°, 315°) y nueve posiciones (centro, arriba, arriba derecha, derecha, abajo derecha, abajo, abajo izquierda, izquierda, arriba izquierda) sin necesidad de conocer la estructura interna de los PDFs.

Soporte para marcas de texto e imagen

Aplique marcas de agua basadas en texto o en imágenes según sus necesidades. Las marcas de agua de texto admiten el control tipográfico completo con propiedades de fuente personalizables, mientras que las marcas de agua de imagen aceptan múltiples formatos (PDF, JPG, JPEG, BMP, PNG, GIF, WWF, TIF, TIFF) con opciones de escalado del 1% al 500%. Esta flexibilidad permite tanto sellos de texto simples como marcas de agua visuales complejas, como logotipos o firmas, sin código adicional para el procesamiento de imágenes.

Procesamiento selectivo de páginas

Segmentar páginas específicas o rangos de páginas con precisión utilizando la sintaxis de selección de página intuitiva. La API acepta números de página separados por comas y rangos con guiones (por ejemplo, "1,3,5-7"), lo que le permite aplicar marcas de agua solo cuando sea necesario. Esta capacidad es particularmente valiosa para documentos con secciones distintas que requieren diferentes tratamientos de marcas de agua, como apéndices, páginas de portada o áreas de contenido específicas.

Control de capas y opacidad

Posiciona las marcas de agua encima o detrás del contenido existente con el parámetro isBehind. Cuando se colocan encima, las marcas de agua superponen el contenido existente; cuando están detrás, aparecen como elementos de fondo. Combinado con el control de opacidad (escala 0-1), esto proporciona sofisticadas opciones de integración visual. Por ejemplo, establezca la opacidad en 0,3 para marcas de fondo sutiles o 1,0 para avisos de confidencialidad prominentes.

Compatibilidad con documentos protegidos por contraseña

Procese PDFs protegidos proporcionando la contraseña del documento en su solicitud de API. Esta característica mantiene la seguridad a lo largo del flujo de trabajo de marcas de agua y elimina la necesidad de pasos separados de descifrado/encriptación en la lógica de su aplicación. La API maneja la autenticación de forma transparente, preservando toda la seguridad del documento existente mientras se agregan marcas de agua.

Arquitectura de procesamiento asincrónico

Diseñada para manejar documentos de distintos tamaños con fiabilidad, la API utiliza un modelo asincrónico. Las operaciones devuelven un ID de forma inmediata, permitiéndote consultar el estado y obtener resultados cuando el procesamiento haya finalizado. Esto evita interrupciones por tiempo de espera y facilita la integración en aplicaciones basadas en eventos.

POST/add-watermark-to-pdf/v1
Content-Type:multipart/form-data

// Request body parameters
file: [binary PDF file]
text: "CONFIDENTIAL"
position: "center"
opacity: 0.5
rotation: "45"

Gestión simple de archivos

Carga archivos PDF desde el almacenamiento local, Google Drive, Dropbox o mediante interfaces de arrastrar y soltar. La API admite archivos de hasta 10 MB, adecuados para la mayoría de documentos de negocio. Una vez procesados, los documentos pueden recuperarse por programación o almacenarse directamente para su uso posterior.

Soporte para múltiples formatos de imagen

Al usar marcas de agua de imágenes, la API admite una amplia gama de formatos más allá de JPG y PNG. Acepta archivos PDF, BMP, GIF, WWF, TIF y TIFF como fuentes de marca de agua, lo que permite a los usuarios implementar marcas de agua visuales complejas sin conversión de formato. La API también admite la extracción de páginas específicas de PDFs fuente multipágina como marcas de agua.

Ventajas de implementación técnica

API RESTful vs. bibliotecas tradicionales

Nuestra API Watermark PDF ofrece ventajas significativas sobre las bibliotecas tradicionales de procesamiento de PDF:

Característica
Tiempo de implementación
Watermark PDF API
Minutos
Bibliotecas tradicionales
Horas o días
Característica
Recursos del servidor
Watermark PDF API
Procesamiento externo
Bibliotecas tradicionales
Consumo local de CPU y memoria
Característica
Mantenimiento
Watermark PDF API
Actualizaciones automáticas
Bibliotecas tradicionales
Gestión manual de dependencias
Característica
Compatibilidad multiplataforma
Watermark PDF API
Cualquier lenguaje con soporte HTTP
Bibliotecas tradicionales
Dependiente del lenguaje/plataforma
Característica
Escalabilidad
Watermark PDF API
Incorporada
Bibliotecas tradicionales
Requiere implementación adicional

La API elimina conflictos de dependencias, problemas de compatibilidad y gestión de versiones, garantizando resultados consistentes.

Opciones de integración con SDK

Para desarrolladores que necesiten una integración más profunda, el SDK complementario ofrece:

Soporte nativo para lenguajes populares

Procesamiento sin conexión para entornos cerrados

Manejo de eventos y seguimiento del progreso

Mecanismos integrados de recuperación de errores

Superficie de API unificada entre modelos en la nube y locales

El SDK mantiene la misma estructura de parámetros que la API REST, lo que permite transiciones sin problemas entre implementaciones en la nube y en las instalaciones a medida que evolucionan los requisitos.

Control avanzado de documentos

Más allá del simple marcado, la solución permite:

Aplicar marcas condicionalmente según contenido o metadatos

Crear marcas dinámicas con fecha, usuario o códigos de seguimiento

Combinar texto e imagen en marcas multicapa

Automatizar flujos de trabajo sin intervención del usuario

Aplicar marcas diferentes a páginas pares e impares mediante subset

Esta flexibilidad admite requisitos sofisticados de gestión de documentos sin código de manipulación de PDF personalizado.

Implementación técnica

La API sigue convenciones REST estándar:

  • Autenticación

    Obtén tu clave API en el portal de desarrolladores

  • Resultado

    Usa el ID para consultar el estado y descargar el documento

  • Solicitud

    POST a /add-watermark-to-pdf/v1

  • Respuesta

    Obtén el ID de operación

  • Configuración

    Define los parámetros de marca

La API devuelve una respuesta 202 aceptada con un identificador de operación para el procesamiento asíncrono:

{
"id":"3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Use this ID with /operation/v1/{operationId}/status to monitor progress and retrieve results when processing completes



Técnicas avanzadas de marca de agua

La API Watermark PDF ofrece un control sofisticado sobre cómo las marcas de agua interactúan con el contenido del documento:
Marca encima del contenido: isBehind: false para visibilidad inmediata
Marca en el fondo: isBehind: true para integración discreta
Múltiples capas: Combina marcas de texto e imagen para efectos complejos

Estas capacidades permiten técnicas avanzadas de marcado de documentos que anteriormente requerían software especializado de edición electrónica.

Comienza a aplicar marcas de agua en PDF hoy mismo

Nuestra Watermark PDF API ofrece una solución poderosa y sencilla para agregar capacidades profesionales de marca de agua a tus aplicaciones y flujos. Con opciones de personalización completas, modelos de implementación flexibles y una integración directa, puedes proteger y personalizar tus documentos sin necesidad de experiencia avanzada en PDF.