Wasserzeichen hinzufügen Word

PDF4me Wasserzeichen hinzufügen Word ist ein REST Endpunkt, der ein Bildwasserzeichen hinter den Text jeder Seite in einem Word dokumentieren. POST die .docx-Datei und das Wasserzeichenbild als Base64 Zu office/ApiV2Word/AddWatermark, Tonhöhe, Transparenz und Ausrichtung anpassen und anschließend die mit einem Wasserzeichen versehene Datei dekodieren. JSON Antwort. PNG, JPG, JPEGEs werden BMP- und GIF-Bilder unterstützt.

Was dieser Endpunkt bewirkt

Benötigt eine Word Das Dokument wird um ein Bild ergänzt und gibt dasselbe Dokument zurück, wobei das Bild hinter dem Text jedes Abschnitts eingefügt wird: ein Logo, ein „Vertraulich“-Banner, ein „Entwurf“-Stempel. Sie können die Größe (exakte Punkte oder einen Skalierungsfaktor), die Transparenz (50 %) und die Platzierung (zentriert oder oben links) festlegen. Die Antwort lautet: JSON mit dem Ergebnis Base64 Inhalt.

Verwandte Blog-Beiträge

Zu dieser Funktion gibt es noch keinen Blogbeitrag – folgt in Kürze.

Schauen Sie sich in der Zwischenzeit im PDF4me-Blog Tutorials und Arbeitsabläufe für alle Plattformen an.

Besuchen Sie den Blog →

Authentifizierung Ihres API Anfrage

Jeder PDF4me REST Der Anruf muss Ihre API Schlüssel im Authorization Header als Basic Auth. Ihren Schlüssel erhalten oder ändern Sie ihn im Entwickler-Dashboard.

Get your API Key

Endpunkt

POSToffice/ApiV2Word/AddWatermark

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

Wichtige Fakten, die Sie nicht verpassen sollten

Die Antwort lautet: Base64 JSONnicht die Datei

Das mit einem Wasserzeichen versehene Dokument wird als ein Base64 Zeichenkette innerhalb eines JSON Körper mit fileName, success, Und Fehlermeldung. Vor dem Speichern dekodieren; die Rohantwort ist kein gültiges .docx-Format.

Breite und Höhe überschreiben die Skalierung

Die Priorität bei der Größenbestimmung ist exakt. Breite/Höhe zuerst in Punkten, dann SkalaDann die ursprüngliche Bildgröße. Senden Sie nur eine Dimension, die andere wird so berechnet, dass das Seitenverhältnis erhalten bleibt.

Hinter dem Text, in jedem Abschnitt

Das Bild wird in allen Abschnitten und Überschriften hinter dem Dokumentinhalt eingebettet, sodass der Text lesbar bleibt. PNG plus halbtransparent: wahr verleiht den klassischen, dezenten Stempel-Look.

HTTP aufstellen

Verfahren: POST
URL: https://api.pdf4me.com/office/ApiV2Word/AddWatermark
Inhaltstyp: application/json
Authorization: Basic <Ihre PDF4me API Schlüssel>

Die Antwort lautet: JSON: Überprüfen Sie die success Flagge, dann Base64-Dekodiere den zurückgegebenen Dokumentinhalt und speichere ihn mit einem .docx Verlängerung.

Wie funktioniert die Priorität der Wasserzeichengrößenfestlegung?

Es gibt drei Größenparameter, die streng nach Rangfolge geordnet sind. API Verwendet die Eingabe mit der höchsten Priorität, die Sie tatsächlich senden, und ignoriert den Rest.

Dimensionierung von Eingangssignalen im Vergleich zum Verhalten	Wenn es zutrifft	Was das Wasserzeichen erhält
`width` Und `height` (Punkte)	Höchste Priorität; überschreibt `scale` wenn vorhanden	Genau die von Ihnen angegebenen Abmessungen. Eine einzige Abmessung erhält das Seitenverhältnis.
`scale` (0,1 bis 10,0)	Wird nur verwendet, wenn keine Breite oder Höhe angegeben wird.	Die ursprüngliche Bildgröße wird mit dem Faktor multipliziert: 0,5 entspricht der halben Größe, 2,0 der doppelten Größe.
Auch nicht geschickt	Zurückgreifen	Die ursprünglichen Pixelabmessungen des hochgeladenen Bildes

API Körperfelder

Parameter	Erforderlich	Typ	Was es tut	Beispiel
`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`

Beispielnutzlasten

Minimale Anforderung (nur Pflichtfelder)

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

Größe angepasst, halbtransparent, zentriert

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

Tipps zur Postboten-Abholung

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.

curl-Beispiel

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

Was bedeutet das? API zurückkehren?

A JSON Ergebnis, das das mit einem Wasserzeichen versehene Dokument enthält Base64Die

Feld	Typ	Was es enthält
`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.

Asynchrones Verhalten (202 Accepted mit einer Umfrage URL im Location Der Header wird durch die Serverkonfiguration gesteuert, nicht durch einen Parameter im Anfragetext. Wenn ein 202-Statuscode eintrifft, wird der Header abgefragt. Location URL mit GET Stellen Sie so lange Anfragen, bis Sie 200 erhalten. OK mit dem gleichen JSON Form.

Codebeispiele

Word Die Office-Endpunkte sind noch nicht durch endpunktbezogene Beispielordner im Beispiel-Repository abgedeckt; es enthält das von jedem verwendete Anfragemuster. PDF4me Endpunktfamilie:

View API Samples Repository

Häufig gestellte Fragen

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.

Warum Wasserzeichen hinzufügen über API statt manuell in Word?

Der manuelle Weg ist Einfügen eines Bildwasserzeichens in WordJede Datei öffnen, Registerkarte „Design“, Wasserzeichen, Benutzerdefiniertes Wasserzeichen, Bild auswählen, speichern, wiederholen. Das ist nicht skalierbar für einen Vertragsablauf, der jeden ausgehenden Entwurf mit einem Wasserzeichen versieht. API wendet denselben Stempel hinter dem Text an wie eine deterministische Anfrage pro Datei, mit exakter Punktgröße, die Word Der Dialog wird nicht angezeigt. Das Ergebnis ist Standard. digitale Wasserzeichen zur Herkunfts- und Statuskennzeichnung, die in Pipeline-Geschwindigkeit angewendet wird.