Textstempel hinzufügen PDF - Textwasserzeichen API

PDF4me Textstempel hinzufügen PDF ermöglicht es Ihnen, anpassbare Textwasserzeichen hinzuzufügen PDF Dokumente zur Autorisierung und zur Verhinderung von Produktpiraterie. API Serviceprozesse PDF Dateien und fügt Textstempel hinzu, wobei Text, Position, Formatierung, Drehung und Aussehen individuell angepasst werden können. API empfängt PDF Inhalte durch REST API Anrufe, die genutzt werden Base64 Verschlüsselung für sichere Übertragung. Diese Lösung eignet sich ideal für Dokumentenbranding, Urheberrechtsschutz, Statusanzeigen und Unternehmenszwecke. 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

Flexible Positionierung: Horizontale und vertikale Ausrichtung mit pixelgenauer Präzision steuern
Individuelles Styling: Wählen Sie aus verschiedenen Schriftarten, Größen, Farben und Texteffekten (fett, kursiv, unterstrichen)
Erweiterte FormatierungDeckkraft, Drehung, Ränder und Hintergrundoptionen festlegen
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 Wasserzeichen, die die Dokumentensicherheit und das Branding verbessern
Asynchrone VerarbeitungUnterstützung für die asynchrone Verarbeitung mit Polling für langlaufende Operationen

REST API Endpunkt

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

Verfahren: POST
Endpunkt: /api/v2/Stamp

Unterstützte Textstempelfunktionen

Der API bietet umfassende Unterstützung für verschiedene Textstempel- und Wasserzeichenfunktionen:

Textanpassungsoptionen

SchriftartauswahlWählen Sie zwischen Arial, Times New Roman, Helvetica oder Courier New Roman.
Größenkontrolle: Einstellbare Schriftgröße von 8 bis 72
Farboptionen: Unterstützung des gesamten Farbspektrums mit Hex-Farbcodes (z. B. #FF0000 für Rot)
TexteffekteFormatierungsoptionen: Fett, Kursiv und Unterstrichen
Benutzerdefinierter TextUnterstützung für beliebige Textinhalte einschließlich Symbole und Sonderzeichen

Positionierung und Layout

Horizontale Ausrichtung: Positionierungsoptionen links, mittig und rechts
Vertikale Ausrichtung: Steuerung der Platzierung oben, in der Mitte und unten
MargenkontrollePräzise Positionierung mit millimeter- und pixelbasierten Messungen
RotationsunterstützungTextrotation: 0 (horizontal), 45 (diagonal), 90 (vertikal), -45 (umgekehrt diagonal)
Flexible PlatzierungUnterstützung für jede Seitenposition mit exakten Messungen

Erweiterte Funktionen

Opazitätskontrolle: Einstellbare Transparenz (0-100) für dezente oder auffällige Wasserzeichen
HintergrundmodusOption zum Platzieren von Text hinter oder vor dem Inhalt
Drucksteuerung: Konfigurieren Sie, ob Stempel in der Ansicht angezeigt und gedruckt oder nur gedruckt werden sollen.
Seitenausrichtung: Auf bestimmte Seiten oder ganze Dokumente anwenden
TextanpassungAutomatische Textgrößenanpassung an Seitenränder (optional)

REST API Parameter

Vollständige Liste der Parameter für die Funktion „Textstempel 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

Parameter	Typ	Beschreibung	Beispiel
docName*	Zeichenkette	Ausgabe PDF Dateiname mit der Erweiterung .pdf	`output.pdf`
docContent*	Base64	PDF Dateiinhalt kodiert in Base64	`JVBERi...`
Seiten*	Zeichenkette	Seitenoptionen: "alle", "1", "1,3,5", "2-5", "1,3,7-10", "2-"	`all`
Text*	Zeichenkette	Text, der als Wasserzeichen verwendet werden soll	`CONFIDENTIAL - PDF4me Watermark`
alignX*	Zeichenkette	Horizontale Ausrichtung: links, Center, oder Rechts	`center`
Ausrichtung*	Zeichenkette	Vertikale Ausrichtung: Spitze, Mitte, oder unten	`middle`

Optionale Parameter

Parameter	Typ	Beschreibung	Beispiel
marginXInMM	Zeichenkette	Horizontaler Abstand vom linken Rand in Millimetern	`50`
Rand Y In MM	Zeichenkette	Vertikaler Abstand von der Oberkante in Millimetern	`50`
marginXInPx	Zeichenkette	Horizontaler Abstand vom linken Rand in Pixeln	`150`
marginYInPx	Zeichenkette	Vertikaler Abstand vom oberen Rand in Pixeln	`150`
Opazität	Zeichenkette	Deckkraft (0-100): 0 = unsichtbar, 100 = vollständig undurchsichtig	`30`
Schriftartname	Zeichenkette	Schriftartname: Arial, Times New Roman, Helvetica, Kurier Neu	`Arial`
Schriftgröße	Ganze Zahl	Schriftgröße (8-72)	`24`
Schriftfarbe	Zeichenkette	Schriftfarbe im Hexadezimalformat (z. B. #FF0000 für Rot)	`#FF0000`
Eisball	Boolescher Wert	Text fett (wahr) oder normal (falsch) formatieren	`true`
isItalics	Boolescher Wert	Text kursiv (wahr) oder normal (falsch) formatieren	`false`
unterstreichen	Boolescher Wert	Unterstreiche den Text (wahr) oder nicht (falsch)	`false`
drehen	Ganze Zahl	Drehwinkel: 0 (horizontal), 45 (diagonal), 90 (vertikal), -45 (umgekehrte Diagonale)	`45`
istHintergrund	Boolescher Wert	Stempel im Hintergrund (wahr) oder Vordergrund (falsch) platzieren	`true`
Nur in der Printausgabe anzeigen	Boolescher Wert	Stempel anzeigen und drucken (falsch) oder nur drucken (wahr)	`false`
quer	Boolescher Wert	Transversale Positionierung (wahr) oder normal (falsch)	`false`
Text über Seite anpassen	Boolescher Wert	Text über die gesamte Seite anpassen (true) oder festgelegte Größe verwenden (false)	`false`
asynchron	Boolescher Wert	Aktivieren Sie die asynchrone Verarbeitung. Wenn `true`, Die API Gibt den Statuscode 202 zurück und stellt eine Abfrage bereit. URL im Location Überschrift	`true`

Ausgabe

Der PDF4me Textstempel 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.

Success Response
Asynchronous Processing
Error Responses
Response Format Details

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 hinzugefügtem Textstempel, kodiert als Base64 Zeichenkette

Anwendungshinweise:

Extrahieren Sie die docContent Feld vom JSON Antwort
Entschlüsseln Sie die Base64 Zeichenkette, um die Binärdatei zu erhalten PDF Daten
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

Asynchrone Verarbeitung

Wann async: true ist festgelegt, die API verarbeitet die Anfrage asynchron:

Statuscode: 202 Accepted

Antwort-Header:

Location: https://api.pdf4me.com/api/v2/Stamp/poll/12345-abcde-67890

Abstimmungsverfahren:

Extrahieren Sie die Location Header der 202-Antwort
Befragen Sie die URL Verwendung GET Anfragen
Nehmen Sie so lange an der Umfrage teil, bis Sie eine Antwort erhalten. 200 OK Status
Die endgültige Antwort enthält dasselbe JSON Format mit docName Und docContent (Base64)

Umfragebeispiel:

// Initial request returns 202 with Location header
const response = await fetch(url, options);
const location = response.headers.get('Location');

// Poll until complete
while (true) {
  const pollResponse = await fetch(location, { headers: { 'Authorization': 'Basic ' + apiKey } });
  if (pollResponse.status === 200) {
    const data = await pollResponse.json();
    // Process data.docContent (Base64 PDF)
    break;
  }
  await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2 seconds
}

Fehlermeldungen

Der API Standard-Rückgabe HTTP Fehlercodes mit Fehlerdetails:

400 Bad Request

Ungültige Anfrageparameter
Fehlende Pflichtfelder (docContent, docName, Seiten, Text, alignX, alignY)
Ungültig Base64 Kodierung in docContent
Ungültige Ausrichtungswerte (müssen für alignX "left", "center", "right" und für alignY "top", "middle", "bottom" sein).
Ungültige Schriftgröße (muss zwischen 8 und 72 liegen)
Ungültiger Deckkraftwert (muss zwischen 0 und 100 liegen)

401 Unauthorized

Ungültig oder fehlend API Schlüssel
API Schlüssel nicht richtig Base64 kodiert in Authorization Überschrift
Fehlen Autorisierung: Basis Überschrift

500 Internal Server Error

Serverseitiger Verarbeitungsfehler
PDF Verarbeitungsfehler
Fehler beim Hinzufügen eines Textstempels

Fehlerantwortformat:

{
  "error": "Error message describing what went wrong"
}

Details zum Antwortformat

Wichtig: Der API kehrt immer zurück JSONniemals binär PDF Daten direkt.

Antwortstruktur:

{
  "docName": "string",      // Output PDF filename
  "docContent": "string"    // Base64-encoded PDF content
}

Content-Type Überschrift:

Erfolg: application/json
Der PDF ist eingebettet als Base64 Zeichenkette innerhalb der JSON Antwort

Warum Base64?

JSON-sichere Kodierung für Binärdaten
Einfach zu übertragen über HTTP
Kompatibel mit allen Programmiersprachen
Kann direkt eingebettet werden in JSON ohne den Problemen auszuweichen

Dekodierung Base64 Zu PDF:

JavaScript/Node.js:

const base64 = response.docContent;
const binary = atob(base64); // Browser
// OR
const binary = Buffer.from(base64, 'base64').toString('binary'); // Node.js

Python:

import base64
pdf_bytes = base64.b64decode(response['docContent'])
with open('output.pdf', 'wb') as f:
    f.write(pdf_bytes)

C#:

byte[] pdfBytes = Convert.FromBase64String(response.docContent);
File.WriteAllBytes("output.pdf", 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==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle"
}

Erweitertes Beispiel (mit allen optionalen Feldern):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle",
  "marginXInMM": "50",
  "marginYInMM": "50",
  "marginXInPx": "150",
  "marginYInPx": "150",
  "opacity": "30",
  "fontName": "Arial",
  "fontSize": 24,
  "fontColor": "#FF0000",
  "isBold": true,
  "isItalics": false,
  "underline": false,
  "rotate": 45,
  "isBackground": true,
  "showOnlyInPrint": false,
  "transverse": false,
  "fitTextOverPage": false,
  "async": true
}

Codebeispiele

Der PDF4me Textstempel 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) Beispiel

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

View C# Sample

Textstempelfunktionen

Anpassungsoptionen

SchriftartsteuerungMehrere Schriftfamilien mit Größen- und Farbanpassung
TexteffekteFormatierungsoptionen: Fett, Kursiv und Unterstrichen
FarbmanagementVollständige Farbspektrumunterstützung mit Hex-Codes
TextinhaltUnterstützung für beliebigen Text einschließlich Symbolen und Sonderzeichen
Professionelles StylingHochwertige Textwiedergabe mit klarer Lesbarkeit

Positionierung und Layout

AusrichtungskontrollePräzise horizontale und vertikale Ausrichtungsoptionen
Randeinstellungen: Sowohl millimeter- als auch pixelbasierte Positionierung
Rotationsunterstützung: Textdrehung für diagonale oder schräge Wasserzeichen
Flexible PlatzierungUnterstützung für jede Seitenposition und -ausrichtung
Seitenausrichtung: Auf bestimmte Seiten oder ganze Dokumente anwenden

Erweiterte Funktionen

Opazitätskontrolle: Einstellbare Transparenz für dezente oder auffällige Wasserzeichen
HintergrundmodusOption zum Platzieren von Text hinter oder vor dem Inhalt
Drucksteuerung: Stempel so konfigurieren, dass sie nur im Druck oder nur auf dem Bildschirm angezeigt werden.
TextanpassungAutomatische Textgrößenanpassung an die Seitenränder
Transversalmodus: Stempel auf die gesamte Seite aufbringen

Branchenspezifische Anwendungsfälle und Anwendungen

Legal & Professional Services
Business & Enterprise
Finance & Banking
Government & Compliance

Anwendungsfälle für Rechts- und Beratungsdienstleistungen

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

Hilfe erhalten

Get Your API Key API Samples Getting Started

Authentifizierung Ihres API Anfrage​

Hauptmerkmale​

REST API Endpunkt​

Unterstützte Textstempelfunktionen​

Textanpassungsoptionen​

Positionierung und Layout​

Erweiterte Funktionen​

REST API Parameter​

Erforderliche Parameter​

Optionale Parameter​

Ausgabe​

Beispielanfrage​

Kopfzeile​

Nutzlast​

Codebeispiele​

Textstempelfunktionen​

Anpassungsoptionen​

Positionierung und Layout​

Erweiterte Funktionen​

Branchenspezifische Anwendungsfälle und Anwendungen​

Hilfe erhalten​

Authentifizierung Ihres API Anfrage

Hauptmerkmale

REST API Endpunkt

Unterstützte Textstempelfunktionen

Textanpassungsoptionen

Positionierung und Layout

Erweiterte Funktionen

REST API Parameter

Erforderliche Parameter

Optionale Parameter

Ausgabe

Beispielanfrage

Kopfzeile

Nutzlast

Codebeispiele

Textstempelfunktionen

Anpassungsoptionen

Positionierung und Layout

Erweiterte Funktionen

Branchenspezifische Anwendungsfälle und Anwendungen

Hilfe erhalten