Agregar marca de agua a Word

PDF4me Agregar marca de agua a Word es un REST punto final que estampa una marca de agua de imagen detrás del texto de cada página en un Word documento. POST el archivo .docx y la imagen de marca de agua como Base64 a office/ApiV2Word/AddWatermark, ajuste la escala, la transparencia y la alineación, luego decodifique el archivo con marca de agua desde el JSON respuesta. PNG, JPG, JPEGSe admiten imágenes en formato BMP y GIF.

Lo que hace este punto final

Toma un Word documento más una imagen y devuelve el mismo documento con esa imagen estampada detrás del texto de cada sección: un logotipo, un banner CONFIDENCIAL, un sello BORRADOR. Usted controla el tamaño (puntos exactos o un factor de escala), un interruptor de transparencia del 50 por ciento y la ubicación central o superior izquierda. La respuesta es JSON con el resultado como Base64 contenido.

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

Cada PDF4me REST La llamada debe incluir su API clave en el Authorization Encabezado como autenticación básica. Obtenga o cambie su clave desde el panel de desarrollador.

Get your API Key

Punto final

POSTOffice/ApiV2Word/AgregarMarcaDeAgua

cartero URLhttps://api.pdf4me.com/office/ApiV2Word/AddWatermark

Datos importantes que no debes perderte

La respuesta es Base64 JSON, no el archivo

El documento con marca de agua regresa como un Base64 cuerda dentro de un JSON cuerpo con fileName, success, y mensaje de error. Decodifícalo antes de guardarlo; la respuesta sin procesar no es un archivo .docx válido.

Escala de anulación de ancho y alto

La prioridad de tamaño es exacta ancho/altura primero en puntos, luego escala, luego el tamaño de la imagen original. Se envía solo una dimensión y la otra se calcula para mantener la relación de aspecto.

Detrás del texto, en cada sección

La imagen se superpone al contenido del documento en todas las secciones y encabezados, de modo que el texto permanece legible. Una imagen transparente PNG más semitransparente: verdadero Proporciona el aspecto clásico de un sello discreto.

HTTP configuración

Método: POST
URL: https://api.pdf4me.com/office/ApiV2Word/AddWatermark
Tipo de contenido: aplicación/json
Authorization: Básico <tu PDF4me API clave>

La respuesta es JSON: comprobar el success bandera, entonces Base64-decodificar el contenido del documento devuelto y guardarlo con un .docx extensión.

¿Cómo funciona la prioridad de tamaño de la marca de agua?

Existen tres parámetros de dimensionamiento y están estrictamente clasificados. API Utiliza la entrada de mayor prioridad que usted envíe e ignora el resto.

Dimensionamiento de la entrada frente al comportamiento	Cuando se aplica	Lo que obtiene la marca de agua
`width` y `height` (puntos)	Máxima prioridad; anula `scale` cuando esté presente	Exactamente las dimensiones que especifique. Una sola dimensión mantiene la relación de aspecto.
`scale` (0,1 a 10,0)	Se utiliza únicamente cuando no se envía ningún ancho ni alto.	Tamaño de la imagen original multiplicado por el factor: 0,5 es la mitad del tamaño, 2,0 es el doble.
Ninguno envió	Retroceder	Las dimensiones originales en píxeles de la imagen subida

API campos corporales

Parámetro	Requerido	Tipo	Lo que hace	Ejemplo
`document`	Required	object	Document reference carrying Name, the Word filename with its .docx extension.	`{ "Name": "document.docx" }`
`docContent`	Required	string	Base64-encoded bytes of the Word document to watermark.	`UEsDBBQABgAIAAAA...`
`watermarkFileName`	Required	string	Watermark image filename with its extension. PNG, JPG, JPEG, BMP, and GIF are supported.	`watermark.png`
`watermarkFileContent`	Required	string	Base64-encoded bytes of the watermark image. A PNG with a transparent background gives the cleanest behind-text result.	`iVBORw0KGgo...`
`scale`	Optional	number	Scale factor from 0.1 to 10.0 applied to the original image size. Default 1.0. Ignored when width or height is sent.	`1.5`
`semiTransparent`	Optional	boolean	true renders the watermark at 50 percent opacity for a subtle stamp; false (default) keeps full opacity.	`true`
`width`	Optional	number	Exact watermark width in points. Overrides scale. If height is omitted it is calculated to keep the aspect ratio.	`200`
`height`	Optional	number	Exact watermark height in points. Overrides scale. If width is omitted it is calculated to keep the aspect ratio.	`150`
`alignImage`	Optional	boolean	true (default) centers the watermark on the page; false aligns it top-left within the margins.	`true`
`cultureName`	Optional	string	Culture code applied to document metadata during processing, for example en-US or de-DE.	`en-US`

Cargas útiles de ejemplo

Solicitud mínima (solo campos obligatorios)

{
 "document": { "Name": "document.docx" },
 "docContent": "UEsDBBQABgAIAAAA...",
 "watermarkFileName": "watermark.png",
 "watermarkFileContent": "iVBORw0KGgoAAAANSUhEUgAA..."
}

De tamaño adecuado, semitransparente, centrado

{
 "document": { "Name": "contract-draft.docx" },
 "docContent": "UEsDBBQABgAIAAAA...",
 "watermarkFileName": "confidential.png",
 "watermarkFileContent": "iVBORw0KGgoAAAANSUhEUgAA...",
 "width": 200,
 "height": 150,
 "semiTransparent": true,
 "alignImage": true,
 "cultureName": "en-US"
}

Consejos para el cobro de carteros

Headers

Content-Type: application/json + Authorization: Basic <apiKey>.

Body

raw JSON with TWO Base64 fields: docContent for the Word file and watermarkFileContent for the image. Both must be encoded separately.

Sizing

Send width/height OR scale, not both. If you send both, the exact dimensions win and scale is silently ignored.

Response

JSON with a success flag and Base64 document content. Decode the document field before saving as .docx.

Ejemplo de curl

curl -X POST https://api.pdf4me.com/office/ApiV2Word/AddWatermark \
 -H "Content-Type: application/json" \
 -H "Authorization: Basic YOUR_API_KEY" \
 -d '{
 "document": { "Name": "document.docx" },
 "docContent": "'"$(base64 -w 0 document.docx)"'",
 "watermarkFileName": "watermark.png",
 "watermarkFileContent": "'"$(base64 -w 0 watermark.png)"'",
 "semiTransparent": true
 }' \
 --output response.json

¿Qué significa el API ¿devolver?

A JSON resultado que contiene el documento con marca de agua como Base64.

Campo	Tipo	Lo que contiene
`document`	String (Base64)	The watermarked Word document content. Decode to bytes and save with a .docx extension.
`fileName`	String	Output filename for the watermarked document.
`success`	Boolean	true when watermarking succeeded. Check this before decoding content.
`errorMessage`	String	Populated when success is false: invalid Base64, a corrupted document or image, or out-of-range sizing values.

Comportamiento asíncrono (202 Accepted con una encuesta URL en el Location El encabezado) está controlado por la configuración del servidor, no por un parámetro del cuerpo de la solicitud. Cuando llega un 202, sondea el Location URL con GET solicitudes hasta que reciba 200 OK con el mismo JSON forma.

Ejemplos de código

Word Los puntos finales de la oficina aún no están cubiertos por carpetas de muestra por punto final en el repositorio de muestras; contiene el patrón de solicitud utilizado por cada PDF4me familia de puntos finales:

View API Samples Repository

Preguntas frecuentes

Which image formats can I use as a Word watermark?+

PNG, JPG, JPEG, BMP, and GIF. A PNG with a transparent background gives the cleanest result because the image is stamped behind the document text on every page.

Is the response the Word file itself?+

No. The API returns JSON containing the watermarked document as a Base64 string plus fileName, success, and errorMessage fields. Decode the document field to bytes before saving as .docx.

What happens if I send both scale and width or height?+

Width and height win. Exact dimensions in points always override the scale factor. If you provide only one of the two, the other is calculated automatically to preserve the image aspect ratio.

Does the watermark cover the document text?+

No. The watermark is placed behind the text, in every section of the document, so the content stays readable. Set semiTransparent to true for a subtle 50 percent opacity effect.

Can this endpoint add text watermarks like DRAFT or CONFIDENTIAL?+

This endpoint stamps images. For text stamps use the Add Text Watermark to Word endpoint, or render your text as a transparent PNG and pass it here as the watermark image.

Where does the watermark appear in the document?+

Across all sections and their headers, behind the content. alignImage true centers it on the page; false places it top-left within the margins. Per-page or per-range placement is not part of this action.

Does adding a watermark protect the document from editing?+

No. A watermark is a visual marker, not a security control; anyone who can edit the file can remove it. To restrict editing or require a password, chain the Secure Word Document endpoint after this one.

¿Por qué agregar marcas de agua a través de...? API en lugar de manualmente en Word¿

La ruta manual es insertar una marca de agua de imagen en Word: abre cada archivo, pestaña Diseño, Marca de agua, Marca de agua personalizada, selecciona la imagen, guarda, repite. Eso no se adapta a un flujo de trabajo contractual que sella cada borrador saliente. El API aplica la misma marca de texto posterior que una solicitud determinista por archivo, con un tamaño de punto exacto que el Word El diálogo no se expone. El resultado es estándar. marca de agua digital para el marcado de procedencia y estado, aplicado a la velocidad de la tubería.