Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog

Agregar sello de imagen a PDF - Marca de agua API

PDF4me Agregar sello de imagen a PDF le permite agregar sellos de imagen y marcas de agua personalizables a PDF documentos. Este API procesos de servicio PDF Los archivos y añaden marcas de agua a las imágenes con posicionamiento preciso, tamaño personalizado y opciones de formato para la marca y seguridad del documento. API recibe PDF datos de contenido e imágenes a través de REST API llamadas, utilizando Base64 Codificación para una transmisión segura. Con soporte para posicionamiento flexible, tamaño personalizado, segmentación de página y control de impresión, esta solución es ideal para la personalización de documentos, la protección de derechos de autor y la gestión empresarial. PDF flujos de trabajo.

Entradas de blog relacionadas
Aún no hay ninguna entrada de blog sobre esta función; estará disponible próximamente.
Mientras tanto, echa un vistazo al blog de PDF4me para encontrar tutoriales y flujos de trabajo para todas las plataformas.
Visita el blog →

Autenticando su API Pedido​

Para acceder al PDF4me REST APICada solicitud debe incluir las credenciales de autenticación adecuadas. La autenticación garantiza una comunicación segura y valida su identidad como usuario autorizado del sistema. REST API.

Get your api Key

Características principales​

  • Compatibilidad con marcas de agua en imágenes: Agregue imágenes personalizadas como marcas de agua y sellos a PDF documentos
  • Posicionamiento flexibleControla la alineación horizontal y vertical con precisión milimétrica.
  • Tallas personalizadas: Ajusta las dimensiones de la imagen utilizando medidas en milímetros y píxeles.
  • Formato avanzado: Configure la opacidad, los márgenes y las opciones de fondo para una apariencia profesional.
  • Segmentación de páginas: Aplicar sellos a páginas específicas o a documentos completos.
  • Control de impresiónConfigure los sellos para que aparezcan solo en la impresión o en la pantalla.
  • Resultados profesionales: Crea marcas de agua en las imágenes que mejoran la seguridad y la imagen de marca de los documentos.
  • Sin fisuras API Integración: REST API diseñado para la automatización PDF flujos de trabajo de edición e integración de sistemas empresariales

REST API Punto final​

El PDF4me REST API utiliza estándar HTTP métodos para interactuar con los recursos. Todas las operaciones de adición de sellos de imagen se realizan a través de un único punto final:

  • Método: POST
  • Punto final: /api/v2/ImageStamp

Características de estampado de imágenes​

Compatibilidad con formatos de imagen​

  • Formatos comunes: Soporte para JPG, PNGGIF y otros formatos de imagen estándar
  • Base64 Codificación: Transmisión segura de imágenes a través de Base64 codificación
  • Control de tamañoOpciones de tamaño tanto en milímetros (10-200 mm) como en píxeles (20-600 px).

Posicionamiento y diseño​

  • Alineación horizontalOpciones de posicionamiento: izquierda, centro o derecha.
  • Alineación verticalControl de posicionamiento superior, medio o inferior
  • Control de márgenesPosicionamiento preciso con mediciones tanto en milímetros (0-100 mm) como en píxeles (0-300 px).
  • Segmentación de páginas: Aplicar a páginas específicas usando opciones de página (cadena vacía para todas las páginas, "1", "1,3,5", "2-5", "1,3,7-10", "2-")

Características avanzadas​

  • Control de opacidadTransparencia ajustable (0-100): 0=invisible, 100=totalmente opaco
  • Modo de segundo plano: Opción para colocar imágenes detrás (isBackground: true) o delante (isBackground: false) de contenido
  • Control de impresión: Configurar los sellos para que aparezcan solo en la impresión (showOnlyInPrint: true) o en vista e impresión (showOnlyInPrint: false)
  • Procesamiento asíncrono: Compatibilidad con el procesamiento asíncrono mediante sondeo para operaciones de larga duración.

REST API Parámetros​

Lista completa de parámetros para Agregar sello de imagen a PDF REST APILos parámetros están organizados por categoría para una mejor comprensión e implementación.

Importante: Los parámetros marcados con un asterisco (*) son obligatorios y deben proporcionarse para la API para que funcione correctamente.

Parámetros requeridos​

ParámetroTipoDescripciónEjemplo
Nombre del documento*StringProducción PDF Nombre del archivo con extensión .pdfoutput.pdf
docContent*Base64El contenido de la entrada PDF archivo codificado en Base64JVBERi...
imageName*StringNombre del archivo de imagen con su extensión (por ejemplo, .png, .jpg)stamp.png
archivo de imagen*Base64Contenido del archivo de imagen codificado en Base64 formatoiVBORw0KGgoAAAANS...
alinearX*StringAlineación horizontal: Izquierda, Centro, o BienCenter
alinearY*StringAlineación vertical: Arriba, Medio, o AbajoMiddle

Parámetros opcionales​

ParámetroTipoDescripciónEjemplo
páginasStringOpciones de página: cadena vacía para todas las páginas, "1" para la página 1, "1,3,5" para páginas específicas, "2-5" para rango de páginas, "1,3,7-10" para mixto, "2-" para las páginas del 2 al final"" o "1-3"
altura en mmStringAltura de la imagen en milímetros (10-200)30
ancho en mmStringAncho de la imagen en milímetros (10-200)30
alturaEnPxStringAltura de la imagen en píxeles (20-600)85
anchoEnPxStringAncho de la imagen en píxeles (20-600)85
margenXEnMMStringMargen horizontal en milímetros (0-100)10
margenYEnMMStringMargen vertical en milímetros (0-100)10
margenXEnPxStringMargen horizontal en píxeles (0-300)28
margenYEnPxStringMargen vertical en píxeles (0-300)28
opacidadIntegerNivel de opacidad (0-100): 0=invisible, 100=totalmente opaco50
es AntecedentesBooleanColocar el sello en segundo plano (verdadero) o en primer plano (falso)true
Mostrar solo en la versión impresaBooleanMostrar solo en la versión impresa (verdadero) o en la versión impresa y en la versión digital (falso)false
asíncronoBooleanHabilitar el procesamiento asíncrono. Cuando true, el API devuelve un estado 202 y proporciona una encuesta URL en el Location encabezadotrue

Producción​

El PDF4me Agregar sello de imagen a PDF REST API devuelve diferentes respuestas según el modo de procesamiento. API devuelve el PDF como un Base64cadena codificada en JSON formato, no como datos binarios.

Procesamiento síncrono (predeterminado)

Cuando async no está configurado o está configurado false, el API procesa la solicitud inmediatamente:

Código de estado: 200 OK

Content-Type: application/json

Cuerpo de la respuesta:

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

Campos de respuesta:

  • Nombre del documento (cadena): La salida PDF Nombre del archivo
  • docContent (cadena): El PDF archivo con sello de imagen aplicado, codificado como Base64 cadena

Cómo usarlo:

  1. Extraer el docContent campo del JSON respuesta
  2. Decodifica el Base64 cadena para obtener el binario PDF datos
  3. Guardar o procesar el PDF Archivo según sea necesario

Ejemplo (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes

Ejemplo de solicitud​

Encabezamiento​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Nota:

  • Consigue tu API clave del PDF4me Panel
  • El API La clave debe ser Base64 codificado y prefijado con "Basic" en el Authorization encabezado
  • Ejemplo: Si su API La clave es abc123, codificarlo a Base64 y usar Authorization: Basic YWJjMTIz

Carga útil​

Ejemplo básico (solo campos obligatorios):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle"
}

Ejemplo avanzado (con todos los campos opcionales):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle",
  "pages": "",
  "heightInMM": "30",
  "widthInMM": "30",
  "heightInPx": "85",
  "widthInPx": "85",
  "marginXInMM": "10",
  "marginYInMM": "10",
  "marginXInPx": "28",
  "marginYInPx": "28",
  "opacity": 50,
  "isBackground": true,
  "showOnlyInPrint": false,
  "async": true
}

Ejemplos de código​

El PDF4me Agregar sello de imagen a PDF REST API Proporciona ejemplos de código en varios lenguajes de programación. Elija el lenguaje que mejor se adapte a su entorno de desarrollo:

C# (CSharp) Muestra

Completo C# implementación para agregar sellos de imagen a PDF:

Casos de uso y aplicaciones en la industria​

Casos de uso de servicios legales y profesionales

  • Documentación legal: Aplicar cláusulas de exención de responsabilidad y avisos de confidencialidad a los documentos legales.
  • Sello de contrato: Añadir sellos de imagen a contratos y acuerdos
  • Avisos de confidencialidadAplicar sellos de confidencialidad a documentos legales sensibles
  • Sellos de conformidad: Agregar avisos de imágenes de cumplimiento normativo a los documentos legales

Obtén ayuda​

Get Your API KeyAPI SamplesGetting Started