Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog

Textwasserzeichen zu Word hinzufügen – Textwasserzeichen API

PDF4me Füge ein Textwasserzeichen zu Word hinzu Ermöglicht das Hinzufügen von individuell anpassbaren Textwasserzeichen zu Word-Dokumenten mit umfassender Kontrolle über Formatierung und Positionierung. API Der Dienst verarbeitet Word-Dateien und fügt Textwasserzeichen hinzu, wobei die volle Kontrolle über Textinhalt, Schriftart, Schriftgröße, Farben, Drehwinkel, Ausrichtungsvoreinstellungen und Transparenzgrade gewährleistet ist. API empfängt Word-Dokumentinhalte über REST API Anrufe, die genutzt werden Base64 Verschlüsselung für sichere Übertragung. Mit Unterstützung für Sicherheitslabels, Branding-Elemente, Vertraulichkeitshinweise und Statusmarkierungen ist diese Lösung ideal für Dokumentensicherheit, Markenschutz und Workflows zur Statusanzeige.

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​

Um auf die PDF4me REST APIJede Anfrage muss die entsprechenden Authentifizierungsdaten enthalten. Die Authentifizierung gewährleistet eine sichere Kommunikation und bestätigt Ihre Identität als autorisierter Benutzer des Systems. REST APIDie

Get your api Key

Hauptmerkmale​

  • Unterstützung für TextwasserzeichenProfessionelle Textwasserzeichen mit beliebigen individuellen Textinhalten
  • SchriftartanpassungVolle Kontrolle über Schriftart, Schriftname und Schriftgröße
  • Farboptionen: Benannte Farben, Hex-Codes, RGB-Werte und Unterstützung für 3-stellige Hex-Werte
  • Rotationssteuerung: Benutzerdefinierte Drehwinkel (0-360°) oder vordefinierte Ausrichtungsvoreinstellungen
  • Transparenzoptionen: Halbtransparente oder vollständig deckende Wasserzeicheneffekte
  • Automatische GrößenanpassungIntelligente Größenanpassung basierend auf Textlänge und Schriftgröße
  • Dokumentenweite Anwendung: Wasserzeichen wurden auf alle Abschnitte und Überschriften angewendet
  • Hinter der Textplatzierung: Wasserzeichen hinter dem Dokumentinhalt

REST API Endpunkt​

Der PDF4me REST API verwendet Standard HTTP Methoden zur Interaktion mit Ressourcen. Alle Operationen zum Hinzufügen von Textwasserzeichen werden über einen einzigen Endpunkt durchgeführt:

  • Verfahren: POST
  • Endpunkt: office/ApiV2Word/AddTextWatermark

REST API Parameter​

Vollständige Liste der Parameter für das Hinzufügen eines Textwasserzeichens zu Word REST APIDie Parameter sind zur besseren Verständlichkeit und Implementierung nach Kategorien geordnet.

Wichtig: Mit einem Sternchen (*) gekennzeichnete Parameter sind erforderlich und müssen angegeben werden. API um ordnungsgemäß zu funktionieren.

Erforderliche Parameter​

ParameterTypBeschreibungBeispiel
dokumentieren*ObjectDokumentenbeschreibung. Muss enthalten Name (Zeichenkette): Ausgabedateiname für Word-Dateien mit der Erweiterung .docx{ "Name": "document.docx" }
docContent*Base64Word-Dokumentinhalt kodiert in Base64UEsDBBQABgAIAAAA...
WasserzeichenText*StringText, der als Wasserzeichen angezeigt werden soll. Erforderlich – darf nicht leer sein oder nur Leerzeichen enthalten. Beispiele: „VERTRAULICH“, „ENTWURF“, „GENEHMIGT“CONFIDENTIAL

Optionale Parameter​

ParameterTypBeschreibungBeispiel
SchriftartStringSchriftart für Wasserzeichentext. Üblich: „Arial“, „Calibri“, „Times New Roman“, „Helvetica“. Standard: „Arial“.Arial
SchriftgrößeNumber (doppelt)Schriftgröße in Punkt (1 bis 1000). Standardwert: 7272
SchriftfarbeStringTextfarbe. Benannt: „Rot“, „Blau“, „Grau“. Hex: „#FF0000“, „FF0000“. RGB: „RGB(255,0,0)“. Standard: „#808080“#FF0000
halbtransparentBooleanTransparenz. true = Deckkraft 50%, false = 100 % (Standardwert)true
DrehungNumber (doppelt)Benutzerdefinierter Drehwinkel (0–360°). Standardwert: 045
SchriftartnameStringSchriftart für WasserzeichentextArial
OrientierungStringVordefinierte Ausrichtung: Horizontal (0°), Vertikal (90°), Diagonale (45°), Verkehrt herum (180°). Überschreibt die Drehung, falls angegeben.Diagonal
KulturnameStringKulturcode (z. B. „en-US“, „de-DE“, „fr-FR“). Standard: nullen-US

Textausrichtungsoptionen​

Die Ausrichtung des Wasserzeichentextes richtet sich nach dieser Parameterpriorität:

  1. Orientierung - Falls angegeben, wird der vordefinierte Orientierungswinkel verwendet.
  2. Drehung - Falls keine Ausrichtung angegeben wird, wird ein benutzerdefinierter Drehwinkel verwendet.
  3. Standard - Falls keiner der beiden Werte angegeben ist, wird 0° (horizontal) verwendet.

Vordefinierte Ausrichtungen:​

  • Horizontal: 0° (Standard)
  • Vertikal90°
  • Diagonale: 45°
  • Verkehrt herum: 180°

Ausgabe​

Der PDF4me Füge ein Textwasserzeichen zu Word hinzu REST API gibt ein zurück JSON Antwort (ApiV2WordApiCallRes). Bei Erfolg API gibt das Word-Dokument als Base64-kodierte Zeichenkette im document Feld, nicht als Binärdaten.

Erfolgsantwort

Statuscode: 200 OK

Inhaltstyp: application/json

Antworttext:

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

Antwortfelder:

  • dokumentieren (Zeichenkette): Das Word-Dokument mit angewendetem Textwasserzeichen, kodiert als Base64
  • Dateiname (Zeichenkette): Der Name der Word-Ausgabedatei
  • Erfolg (boolesch): Gibt an, ob die Operation erfolgreich war.
  • Fehlermeldung (Zeichenkette): Fehlermeldung, falls Erfolg nicht eintritt; andernfalls null.

Anwendungshinweise:

  1. Überprüfen successFalls zutreffend, extrahieren Sie die document Feld vom JSON Antwort
  2. Entschlüsseln Sie die Base64 Zeichenkette zum Abrufen der binären Word-Dokumentdaten
  3. Speichern oder bearbeiten Sie die Word-Datei mit fileName

Beispiel (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

Beispielanfrage​

Kopfzeile​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

Notiz:

  • Hol dir deins API Schlüssel vom PDF4me Armaturenbrett
  • Der API Der Schlüssel muss sein Base64 kodiert und mit "Basic" präfixiert in der Authorization Überschrift
  • Beispiel: Wenn Ihr API Schlüssel ist abc123, kodieren Sie es zu Base64 und verwenden Authorization: Basic YWJjMTIz

Nutzlast​

Einfaches Beispiel (nur Pflichtfelder):

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

Erweitertes Beispiel (mit optionalen Feldern):

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

Beispiel für eine benutzerdefinierte Drehung:

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

Codebeispiele​

Der PDF4me Füge ein Textwasserzeichen zu Word hinzu REST API Es werden Codebeispiele in verschiedenen Programmiersprachen bereitgestellt. Wählen Sie die Sprache, die am besten zu Ihrer Entwicklungsumgebung passt:

C# (CSharp) Beispiel

Vollständig C# Implementierung zum Hinzufügen von Textwasserzeichen zu Word-Dokumenten:

Branchenspezifische Anwendungsfälle und Anwendungen​

Anwendungsfälle für Rechts- und Beratungsdienstleistungen

  • Vertrauliche Dokumente: Rechtsdokumente mit dem Hinweis „VERTRAULICH“ versehen
  • Vertragsentwürfe: Vertragsentwürfe mit dem Status „ENTWURF – IN ÜBERPRÜFUNG“ kennzeichnen.
  • Berechtigungsbezeichnungen: Wasserzeichen mit dem Text "Anwaltsgeheimnis" anwenden
  • StatusanzeigenGeben Sie den Status „GENEHMIGT“ oder „IN ÜBERPRÜFUNG“ an.

Hilfe erhalten​

Get Your API KeyAPI SamplesGetting Started