Zum Hauptinhalt springen
PDF4me APIIntegrationenWissensdatenbankErweiterungenAPI-TesterBlog

Bildstempel hinzufügen PDF - Wasserzeichen API

PDF4me Bildstempel hinzufügen PDF ermöglicht es Ihnen, anpassbare Bildstempel und Wasserzeichen hinzuzufügen PDF Dokumente. Diese API Serviceprozesse PDF Dateien und fügt Bildwasserzeichen mit präziser Positionierung, benutzerdefinierter Größe und Formatierungsoptionen für Dokumentenbranding und -sicherheit hinzu. API empfängt PDF Inhalts- und Bilddaten durch REST API Anrufe, die genutzt werden Base64 Sichere Verschlüsselung für die Übertragung. Dank flexibler Positionierung, benutzerdefinierter Größe, Seitenausrichtung und Drucksteuerung eignet sich diese Lösung ideal für Dokumentenbranding, Urheberrechtsschutz und Unternehmensanwendungen. PDF Arbeitsabläufe.

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 Bildwasserzeichen: Fügen Sie benutzerdefinierte Bilder als Wasserzeichen und Stempel hinzu PDF Dokumente
  • Flexible Positionierung: Horizontale und vertikale Ausrichtung mit pixelgenauer Präzision steuern
  • Maßanfertigung: Bildabmessungen sowohl in Millimetern als auch in Pixeln anpassen.
  • Erweiterte FormatierungLegen Sie Deckkraft, Ränder und Hintergrundoptionen für ein professionelles Erscheinungsbild fest.
  • Seitenausrichtung: Stempel auf bestimmte Seiten oder ganze Dokumente anbringen
  • Drucksteuerung: Stempel so konfigurieren, dass sie nur im Druck oder nur auf dem Bildschirm angezeigt werden.
  • Professionelle Ergebnisse: Erstellen Sie Bildwasserzeichen, die die Dokumentensicherheit und das Branding verbessern
  • Nahtlos API Integration: REST API entwickelt für automatisierte PDF Workflow-Bearbeitung und Integration von Unternehmenssystemen

REST API Endpunkt​

Der PDF4me REST API verwendet Standard HTTP Methoden zur Interaktion mit Ressourcen. Alle Bildstempel-Hinzufügungsoperationen werden über einen einzigen Endpunkt durchgeführt:

  • Verfahren: POST
  • Endpunkt: /api/v2/ImageStamp

Bildstempelfunktionen​

Unterstützung für Bildformate​

  • Gängige FormateUnterstützung für JPG, PNG, GIF und andere Standardbildformate
  • Base64 KodierungSichere Bildübertragung durch Base64 Kodierung
  • Größenkontrolle: Sowohl Millimeter-basierte (10–200 mm) als auch Pixel-basierte (20–600 px) Größenoptionen

Positionierung und Layout​

  • Horizontale AusrichtungPositionierungsoptionen: Links, Mitte oder Rechts
  • Vertikale Ausrichtung: Steuerung der Platzierung oben, Mitte oder unten
  • MargenkontrollePräzise Positionierung mit millimetergenauen (0–100 mm) und pixelgenauen (0–300 px) Messungen.
  • Seitenausrichtung: Auf bestimmte Seiten anwenden mithilfe von Seitenoptionen (leere Zeichenkette für alle Seiten, "1", "1,3,5", "2-5", "1,3,7-10", "2-")

Erweiterte Funktionen​

  • OpazitätskontrolleEinstellbare Transparenz (0-100): 0 = unsichtbar, 100 = vollständig undurchsichtig
  • Hintergrundmodus: Option zum Platzieren von Bildern hinter (isBackground: true) oder vorne (isBackground: false) des Inhalts
  • Drucksteuerung: Stempel so konfigurieren, dass sie nur im Druck angezeigt werden (showOnlyInPrint: true) oder in Sicht und Druck (showOnlyInPrint: false)
  • Asynchrone VerarbeitungUnterstützung für die asynchrone Verarbeitung mit Polling für langlaufende Operationen

REST API Parameter​

Vollständige Liste der Parameter für „Bildstempel hinzufügen“ PDF 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
docName*StringAusgabe PDF Dateiname mit der Erweiterung .pdfoutput.pdf
docContent*Base64Der Inhalt der Eingabe PDF Datei kodiert in Base64JVBERi...
Bildname*StringBilddateiname mit Dateiendung (z. B. .png, .jpg)stamp.png
Bilddatei*Base64Bilddateiinhalt kodiert in Base64 FormatiVBORw0KGgoAAAANS...
alignX*StringHorizontale Ausrichtung: Links, Center, oder RechtsCenter
alignY*StringVertikale Ausrichtung: Spitze, Mitte, oder UntenMiddle

Optionale Parameter​

ParameterTypBeschreibungBeispiel
SeitenStringSeitenoptionen: leere Zeichenkette für alle Seiten, "1" für Seite 1, "1,3,5" für bestimmte Seiten, "2-5" für Seitenbereich "1,3,7-10" für gemischte "2-" für die Seiten 2 bis Ende"" oder "1-3"
Höhe in mmStringBildhöhe in Millimetern (10-200)30
Breite in mmStringBildbreite in Millimetern (10-200)30
Höhe in PixelnStringBildhöhe in Pixel (20-600)85
Breite in PixelnStringBildbreite in Pixel (20-600)85
marginXInMMStringHorizontaler Rand in Millimetern (0-100)10
Rand Y In MMStringVertikaler Rand in Millimetern (0-100)10
marginXInPxStringHorizontaler Rand in Pixeln (0-300)28
marginYInPxStringVertikaler Rand in Pixeln (0-300)28
OpazitätIntegerDeckkraft (0-100): 0 = unsichtbar, 100 = vollständig undurchsichtig50
istHintergrundBooleanStempel im Hintergrund (wahr) oder Vordergrund (falsch) platzierentrue
Nur in der Printausgabe anzeigenBooleanNur in der Druckansicht anzeigen (wahr) oder in der Ansicht und im Druckmodus (falsch)false
asynchronBooleanAktivieren Sie die asynchrone Verarbeitung. Wenn true, Die API Gibt den Statuscode 202 zurück und stellt eine Abfrage bereit. URL im Location Überschrifttrue

Ausgabe​

Der PDF4me Bildstempel hinzufügen PDF REST API Die Antwort hängt vom Verarbeitungsmodus ab. API gibt zurück PDF als Base64-kodierte Zeichenkette in JSON Format, nicht als Binärdaten.

Synchrone Verarbeitung (Standard)

Wann async ist nicht festgelegt oder auf gesetzt false, Die API verarbeitet die Anfrage sofort:

Statuscode: 200 OK

Content-Type: application/json

Antworttext:

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

Antwortfelder:

  • docName (Zeichenkette): Die Ausgabe PDF Dateiname
  • docContent (Zeichenkette): Die PDF Datei mit angewendetem Bildstempel, kodiert als Base64 Zeichenkette

Anwendungshinweise:

  1. Extrahieren Sie die docContent Feld vom JSON Antwort
  2. Entschlüsseln Sie die Base64 Zeichenkette, um die Binärdatei zu erhalten PDF Daten
  3. Speichern oder verarbeiten Sie die PDF Datei nach Bedarf

Beispiel (JavaScript):

const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes

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

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle"
}

Erweitertes Beispiel (mit allen optionalen Feldern):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageName": "stamp.png",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "alignX": "Center",
  "alignY": "Middle",
  "pages": "",
  "heightInMM": "30",
  "widthInMM": "30",
  "heightInPx": "85",
  "widthInPx": "85",
  "marginXInMM": "10",
  "marginYInMM": "10",
  "marginXInPx": "28",
  "marginYInPx": "28",
  "opacity": 50,
  "isBackground": true,
  "showOnlyInPrint": false,
  "async": true
}

Codebeispiele​

Der PDF4me Bildstempel hinzufügen PDF REST API Es werden Codebeispiele in verschiedenen Programmiersprachen bereitgestellt. Wählen Sie die Sprache, die am besten zu Ihrer Entwicklungsumgebung passt:

C# (CSharp) Probe

Vollständig C# Implementierung zum Hinzufügen von Bildstempeln zu PDF:

Branchenspezifische Anwendungsfälle und Anwendungen​

Anwendungsfälle für Rechts- und Beratungsdienstleistungen

  • RechtsdokumentationRechtliche Haftungsausschlüsse und Vertraulichkeitshinweise auf juristische Dokumente anwenden
  • Vertragsstempelung: Fügen Sie Verträgen und Vereinbarungen Bildstempel hinzu
  • Vertraulichkeitshinweise: Vertraulichkeitsstempel auf sensible Rechtsdokumente aufbringen
  • Konformitätsstempel: Fügen Sie rechtlichen Dokumenten Bildhinweise zur Einhaltung gesetzlicher Vorschriften hinzu.

Hilfe erhalten​

Get Your API KeyAPI SamplesGetting Started