Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog

Agregar sello de texto a PDF - Marca de agua de texto API

PDF4me Agregar sello de texto a PDF le permite agregar marcas de agua de texto personalizables a PDF documentos para la autorización y la prevención de la piratería. API procesos de servicio PDF archivos y agrega sellos de texto con control sobre el texto, la posición, el estilo, la rotación y la apariencia. API recibe PDF contenido a través de REST API llamadas, utilizando Base64 Codificación para transmisión segura. Esta solución es ideal para la marcación de documentos, la protección de derechos de autor, los indicadores de estado 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​

  • Posicionamiento flexibleControla la alineación horizontal y vertical con precisión milimétrica.
  • Estilo personalizadoElige entre varias fuentes, tamaños, colores y efectos de texto (negrita, cursiva, subrayado).
  • Formato avanzado: Configurar opciones de opacidad, rotación, márgenes y fondo
  • 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 que mejoren la seguridad y la imagen de marca de los documentos.
  • Procesamiento asíncrono: Compatibilidad con el procesamiento asíncrono mediante sondeo para operaciones de larga duración.

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 texto se realizan a través de un único punto final:

  • Método: CORREO
  • Punto final: /api/v2/Stamp

Funciones de sellado de texto compatibles​

El API Proporciona soporte integral para diversas funciones de estampado de texto y marcas de agua:

Opciones de personalización de texto​

  • Selección de fuenteElija entre Arial, Times New Roman, Helvetica o Courier New Roman.
  • Control de tamaño: Tamaño de fuente ajustable de 8 a 72
  • Opciones de color: Compatibilidad con todo el espectro de colores mediante códigos de color hexadecimales (por ejemplo, #FF0000 para el rojo).
  • Efectos de textoOpciones de formato: negrita, cursiva y subrayado.
  • Texto personalizado: Compatibilidad con cualquier contenido de texto, incluidos símbolos y caracteres especiales.

Posicionamiento y diseño​

  • Alineación horizontalOpciones de posicionamiento a la izquierda, al centro y a la derecha.
  • Alineación verticalControl de posicionamiento superior, medio e inferior
  • Control de márgenesPosicionamiento preciso con mediciones tanto en milímetros como en píxeles.
  • Apoyo a la rotaciónRotación del texto: 0 (horizontal), 45 (diagonal), 90 (vertical), -45 (diagonal inversa)
  • Colocación flexible: Compatibilidad con cualquier posición de página con medidas exactas

Características avanzadas​

  • Control de opacidad: Transparencia ajustable (0-100) para marcas de agua sutiles o prominentes.
  • Modo de segundo planoOpción para colocar el texto detrás o delante del contenido.
  • Control de impresión: Configure los sellos para que aparezcan en la vista y se impriman o solo se impriman.
  • Segmentación de páginasAplicar a páginas específicas o a documentos completos.
  • Ajuste de texto: Ajuste automático del tamaño del texto para que se ajuste a los límites de la página (opcional)

REST API Parámetros​

Lista completa de parámetros para Agregar sello de texto 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*CadenaProducción PDF Nombre del archivo con extensión .pdfoutput.pdf
docContent*Base64PDF contenido del archivo codificado en Base64JVBERi...
páginas*CadenaOpciones de página: "todas", "1", "1,3,5", "2-5", "1,3,7-10", "2-"all
texto*CadenaTexto que se estampará como marca de aguaCONFIDENTIAL - PDF4me Watermark
alinearX*CadenaAlineación horizontal: izquierda, centro, o biencenter
alinearY*CadenaAlineación vertical: arriba, medio, o abajomiddle

Parámetros opcionales​

ParámetroTipoDescripciónEjemplo
margenXEnMMCadenaMargen horizontal desde el borde izquierdo en milímetros50
margenYEnMMCadenaMargen vertical desde el borde superior en milímetros50
margenXEnPxCadenaMargen horizontal desde el borde izquierdo en píxeles150
margenYEnPxCadenaMargen vertical desde el borde superior en píxeles150
opacidadCadenaOpacidad (0-100): 0=invisible, 100=totalmente opaco30
nombre de fuenteCadenaNombre de la fuente: Arial, Times New Roman, Helvetica, Mensajero NuevoArial
tamaño de fuenteEnteroTamaño de fuente (8-72)24
color de fuenteCadenaColor de la fuente en formato hexadecimal (por ejemplo, #FF0000 para rojo).#FF0000
Bola de hieloBooleanoPon el texto en negrita (verdadero) o normal (falso)true
isCursivaBooleanoPoner el texto en cursiva (verdadero) o normal (falso)false
subrayarBooleanoSubraya el texto (verdadero) o no (falso).false
girarEnteroÁngulo de rotación: 0 (horizontal), 45 (diagonal), 90 (vertical), -45 (diagonal inversa)45
es AntecedentesBooleanoColocar el sello en segundo plano (verdadero) o en primer plano (falso)true
Mostrar solo en formato impresoBooleanoMostrar el sello en la vista e imprimir (falso) o solo imprimir (verdadero)false
transversoBooleanoPosicionamiento transversal (verdadero) o normal (falso)false
ajustarTextoSobrePáginaBooleanoAjustar el texto a toda la página (verdadero) o usar un tamaño específico (falso)false
asíncronoBooleanoHabilitar 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 texto 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 texto añadido, 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==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle"
}

Ejemplo avanzado (con todos los campos opcionales):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle",
  "marginXInMM": "50",
  "marginYInMM": "50",
  "marginXInPx": "150",
  "marginYInPx": "150",
  "opacity": "30",
  "fontName": "Arial",
  "fontSize": 24,
  "fontColor": "#FF0000",
  "isBold": true,
  "isItalics": false,
  "underline": false,
  "rotate": 45,
  "isBackground": true,
  "showOnlyInPrint": false,
  "transverse": false,
  "fitTextOverPage": false,
  "async": true
}

Ejemplos de código​

El PDF4me Agregar sello de texto 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 texto a PDF:

Funciones de sellado de texto​

Opciones de personalización​

  • Control de fuentesVarias familias tipográficas con opciones de personalización de tamaño y color.
  • Efectos de textoOpciones de formato: negrita, cursiva y subrayado.
  • Gestión del colorCompatibilidad con todo el espectro de colores mediante códigos hexadecimales.
  • Contenido de texto: Admite cualquier tipo de texto, incluidos símbolos y caracteres especiales.
  • Estilismo profesional: Representación de texto de alta calidad con visibilidad clara

Posicionamiento y diseño​

  • Control de alineaciónOpciones de alineación horizontal y vertical precisas.
  • Configuración de márgenesPosicionamiento basado tanto en milímetros como en píxeles.
  • Apoyo a la rotación: Rotación de texto para marcas de agua diagonales o angulares
  • Colocación flexible: Compatibilidad con cualquier posición y orientación de página.
  • Segmentación de páginasAplicar a páginas específicas o a documentos completos.

Características avanzadas​

  • Control de opacidadTransparencia ajustable para marcas de agua sutiles o prominentes.
  • Modo de segundo planoOpción para colocar el texto detrás o delante del contenido.
  • Control de impresiónConfigure los sellos para que aparezcan solo en la impresión o en la pantalla.
  • Ajuste de texto: Ajuste automático del tamaño del texto para que se ajuste a los límites de la página.
  • Modo transversal: Aplique sellos en toda la página.

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: Agregar sellos de estado a contratos y acuerdos
  • Avisos de confidencialidadAplique sellos de confidencialidad a los documentos legales sensibles.
  • Sellos de conformidad: Agregar avisos de cumplimiento normativo a los documentos legales

Obtén ayuda​

Get Your API KeyAPI SamplesGetting Started