Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog

Agregar marca de agua de texto a Word - Marca de agua de texto API

PDF4me Agregar marca de agua de texto a Word le permite agregar marcas de agua de texto personalizables a documentos de Word con un control integral de estilo y posicionamiento. API El servicio procesa archivos de Word y agrega marcas de agua de texto con control total sobre el contenido del texto, la familia de fuentes, el tamaño de fuente, los colores, los ángulos de rotación, los ajustes preestablecidos de orientación y los niveles de transparencia. API recibe el contenido del documento de Word a través de REST API llamadas, utilizando Base64 Codificación para una transmisión segura. Con soporte para etiquetas de seguridad, elementos de marca, avisos de confidencialidad e indicadores de estado, esta solución es ideal para la seguridad de documentos, la protección de marca y los flujos de trabajo de indicación de estado.

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 de textoMarcas de agua de texto profesionales con cualquier contenido de texto personalizado.
  • Personalización de fuentesControl total sobre la familia de fuentes, el nombre de la fuente y el tamaño de la fuente.
  • Opciones de colorColores con nombre, códigos hexadecimales, valores RGB y compatibilidad con códigos hexadecimales de 3 dígitos.
  • Control de rotaciónÁngulos de rotación personalizados (0-360°) o preajustes de orientación predefinidos.
  • Opciones de transparenciaEfectos de marca de agua semitransparentes o totalmente opacos
  • Dimensionamiento automático: Dimensionamiento inteligente basado en la longitud del texto y el tamaño de la fuente.
  • Aplicación a nivel de documentoMarcas de agua aplicadas a todas las secciones y encabezados.
  • Detrás de la colocación del texto: Marcas de agua situadas detrás del contenido del documento

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

  • Método: POST
  • Punto final: office/ApiV2Word/AddTextWatermark

REST API Parámetros​

Lista completa de parámetros para la función Agregar marca de agua de texto a Word. 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
documento*ObjectDescripción del documento. Debe incluir Nombre (cadena): nombre del archivo de Word con extensión .docx{ "Name": "document.docx" }
docContent*Base64Contenido del documento de Word codificado en Base64UEsDBBQABgAIAAAA...
texto de marca de agua*StringTexto que se mostrará como marca de agua. Obligatorio: no puede ser nulo, vacío ni contener solo espacios en blanco. Ejemplos: "CONFIDENCIAL", "BORRADOR", "APROBADO".CONFIDENTIAL

Parámetros opcionales​

ParámetroTipoDescripciónEjemplo
familia de fuentesStringFamilia tipográfica para el texto de la marca de agua. Comunes: "Arial", "Calibri", "Times New Roman", "Helvetica". Predeterminada: "Arial".Arial
tamaño de fuenteNumber (doble)Tamaño de fuente en puntos (de 1 a 1000). Predeterminado: 7272
color de fuenteStringColor del texto. Nombres: "Rojo", "Azul", "Gris". Hexadecimal: "#FF0000", "FF0000". RGB: "RGB(255,0,0)". Predeterminado: "#808080"#FF0000
semiTransparenteBooleanTransparencia. true = opacidad 50%, false = 100% (predeterminado)true
rotaciónNumber (doble)Ángulo de rotación personalizado (0-360°). Predeterminado: 045
nombre de fuenteStringNombre de la fuente para el texto de la marca de aguaArial
orientaciónStringOrientación predefinida: Horizontal (0°), Vertical (90°), Diagonal (45°), Al revés (180°). Anula la rotación si se proporciona.Diagonal
Nombre de la culturaStringCódigo cultural (por ejemplo, "en-US", "de-DE", "fr-FR"). Predeterminado: nuloen-US

Opciones de orientación del texto​

La orientación del texto de la marca de agua sigue esta prioridad de parámetros:

  1. orientación - Si se proporciona, utiliza un ángulo de orientación predefinido.
  2. rotación - Si no se proporciona la orientación, se utiliza un ángulo de rotación personalizado.
  3. Por defecto - Si no se proporciona ninguno, se utiliza 0° (horizontal).

Orientaciones predefinidas:​

  • Horizontal: 0° (predeterminado)
  • Vertical: 90°
  • Diagonal: 45°
  • Al revés: 180°

Producción​

El PDF4me Agregar marca de agua de texto a Word REST API devuelve un JSON respuesta (ApiV2WordApiCallRes). En caso de éxito, API devuelve el documento de Word como un Base64cadena codificada en el document campo, no como datos binarios.

Respuesta de éxito

Código de estado: 200 OK

Tipo de contenido: application/json

Cuerpo de la respuesta:

{
  "document": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
  "fileName": "document.docx",
  "success": true,
  "errorMessage": null
}

Campos de respuesta:

  • documento (cadena): El documento de Word con la marca de agua de texto aplicada, codificado como Base64
  • Nombre del archivo (cadena): El nombre del archivo Word de salida
  • éxito (booleano): Indica si la operación se realizó correctamente.
  • mensaje de error (cadena): Mensaje de error si el éxito es falso; de lo contrario, nulo.

Cómo usarlo:

  1. Controlar success; si es verdadero, extraiga el document campo del JSON respuesta
  2. Decodifica el Base64 cadena para obtener los datos binarios del documento de Word
  3. Guarde o procese el archivo de Word usando fileName

Ejemplo (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
if (!data.success) throw new Error(data.errorMessage);
const wordBytes = atob(data.document);
// Save or process wordBytes

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):

{
  "document": { "Name": "document.docx" },
  "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
  "watermarkText": "CONFIDENTIAL"
}

Ejemplo avanzado (con campos opcionales):

{
  "document": { "Name": "document.docx" },
  "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
  "watermarkText": "CONFIDENTIAL",
  "orientation": "Diagonal",
  "fontFamily": "Arial",
  "fontSize": 72,
  "fontColor": "#FF0000",
  "semiTransparent": true,
  "cultureName": "en-US"
}

Ejemplo de rotación personalizada:

{
  "document": { "Name": "document.docx" },
  "docContent": "UEsDBBQABgAIAAAAIQDfpNJsWgEAACAFAAATAAgCW0NvbnRlbnRfVHlwZXNdLnhtbCCiBAIooAAC...",
  "watermarkText": "DRAFT",
  "fontFamily": "Times New Roman",
  "fontSize": 48,
  "fontColor": "Gray",
  "rotation": 45,
  "semiTransparent": true
}

Ejemplos de código​

El PDF4me Agregar marca de agua de texto a Word 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 marcas de agua de texto a documentos de Word:

Casos de uso y aplicaciones en la industria​

Casos de uso de servicios legales y profesionales

  • Documentos confidenciales: Marca de agua en documentos legales con avisos de "CONFIDENCIAL"
  • Borradores de contratos: Marcar los borradores de acuerdos con el estado "BORRADOR - EN REVISIÓN"
  • Etiquetas de privilegioAplicar marcas de agua con el texto "PRIVILEGIA ABOGADO-CLIENTE"
  • Indicadores de estado: Indicar el estado "APROBADO" o "PENDIENTE DE REVISIÓN"

Obtén ayuda​

Get Your API KeyAPI SamplesGetting Started