Zeichen PDF - Digitale Signatur API

PDF4me Zeichen PDF ermöglicht es Ihnen, Signaturbilder hinzuzufügen PDF Dokumente mit Kontrolle über Position, Größe und Aussehen. API Serviceprozesse PDF Dateien und fügt Signaturbilder hinzu mithilfe von Base64 Verschlüsselung für sichere Übertragung. API empfängt PDF Inhalts- und Signaturbilddaten durch REST API Anrufe. Diese Lösung eignet sich ideal für die Dokumentenauthentifizierung, die Einhaltung gesetzlicher Bestimmungen, Geschäftsprozesse und das Hinzufügen visueller Signaturen zu Dokumenten.

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 Bildsignaturen: Fügen Sie benutzerdefinierte Signaturbilder hinzu zu PDF Dokumente mit voller Kontrolle über Positionierung und Größe
Flexible Positionierung: Horizontale und vertikale Ausrichtung mit pixelgenauer Präzision steuern
Maßanfertigung: Passen Sie die Signaturabmessungen mithilfe von Millimeter- und Pixelmessungen an.
Erweiterte FormatierungLegen Sie Deckkraft, Ränder und Hintergrundoptionen für ein professionelles Erscheinungsbild fest.
Seitenausrichtung: Signaturen auf bestimmte Seiten oder ganze Dokumente anwenden
Drucksteuerung: Signaturen so konfigurieren, dass sie nur im Ausdruck oder nur auf dem Bildschirm angezeigt werden.
Professionelle Ergebnisse: Signaturen erstellen, die die Dokumentenauthentifizierung und -sicherheit 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 PDF Signiervorgänge werden über einen einzigen Endpunkt durchgeführt:

Verfahren: POST
Endpunkt: /api/v2/SignPdf

Unterstützt PDF Signierfunktionen

Der API bietet umfassende Unterstützung für verschiedene PDF Signaturfunktionen:

Unterstützung für Signaturbilder

Gängige FormateUnterstützung für JPG, PNGund andere Standardbildformate
Base64 KodierungSichere Signaturübertragung durch Base64 Kodierung
Flexible Größenanpassung: Sowohl millimeterbasierte (10–200 mm) als auch pixelbasierte (20–600 px) Größenoptionen
Qualitätserhaltung: Behält die charakteristische Bildqualität bei in PDF Ausgabe

Positionierung und Layout

Horizontale Ausrichtung: Positionierungsoptionen links, mittig und rechts
Vertikale Ausrichtung: Steuerung der Platzierung oben, Mitte und unten
MargenkontrollePräzise Positionierung mit millimeter- (0–100 mm) und pixelbasierten (0–300 px) Messungen.
Flexible PlatzierungUnterstützung für jede Seitenposition mit exakten Messungen
Seitenausrichtung: Auf bestimmte Seiten oder ganze Dokumente anwenden (optional)

Erweiterte Funktionen

OpazitätskontrolleEinstellbare Transparenz (0-100) für dezente oder auffällige Unterschriften
HintergrundmodusOption zum Platzieren von Signaturen hinter oder vor dem Inhalt
Drucksteuerung: Signaturen so konfigurieren, dass sie in der Ansicht und beim Drucken oder nur beim Drucken angezeigt werden.
Professionelles AuftretenHochwertige Signaturdarstellung mit klarer Sichtbarkeit

REST API Parameter

Vollständige Liste der Parameter für das Sign 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*	String	Ausgabe PDF Dateiname mit der Erweiterung .pdf	`output.pdf`
docContent*	Base64	PDF Dateiinhalt kodiert in Base64	`JVBERi...`
Bilddatei*	Base64	Inhalt der Signaturbilddatei kodiert in Base64	`iVBORw0KGgoAAAANSUhEUgAA...`
Bildname*	String	Dateiname des Signaturbildes mit Dateiendung (z. B. .jpg, .png)	`signature.jpg`
alignX*	String	Horizontale Ausrichtung: Links, Center, oder Rechts	`Right`
alignY*	String	Vertikale Ausrichtung: Spitze, Mitte, oder Unten	`Bottom`

Optionale Parameter

Parameter	Typ	Beschreibung	Beispiel
Seiten	String	Seitenoptionen: "1", "1,3,5", "2-5", "1,3,7-10", "2-". Falls nicht angegeben, gilt dies für alle Seiten.	`1-3`
Breite in mm	String	Unterschriftenbreite in Millimetern (10-200)	`50`
Höhe in mm	String	Unterschriftenhöhe in Millimetern (10-200)	`25`
Breite in Pixeln	String	Signaturbreite in Pixel (20-600)	`142`
Höhe in Pixeln	String	Signaturhöhe in Pixel (20-600)	`71`
marginXInMM	String	Horizontaler Rand in Millimetern (0-100)	`20`
Rand Y In MM	String	Vertikaler Rand in Millimetern (0-100)	`20`
marginXInPx	String	Horizontaler Rand in Pixeln (0-300)	`57`
marginYInPx	String	Vertikaler Rand in Pixeln (0-300)	`57`
Opazität	String	Deckkraft (0-100): 0 = unsichtbar, 100 = vollständig undurchsichtig	`100`
Nur in der Printausgabe anzeigen	Boolean	Unterschrift anzeigen und drucken (wahr) oder nur drucken (falsch)	`true`
istHintergrund	Boolean	Signatur im Hintergrund (wahr) oder Vordergrund (falsch) platzieren	`false`
asynchron	Boolean	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 Zeichen 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ügter Signatur, 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/SignPdf/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, Bilddatei, Bildname, alignX, Ausrichtung)
Ungültig Base64 Kodierung in docContent oder Bilddatei
Ungültige Ausrichtungswerte (müssen für alignX "Links", "Mitte", "Rechts" und für alignY "Oben", "Mitte", "Unten" sein).
Ungültige Größenwerte (Breite/Höhe müssen innerhalb der angegebenen Bereiche 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 der Signatur

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==",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
  "imageName": "signature.jpg",
  "alignX": "Right",
  "alignY": "Bottom"
}

Erweitertes Beispiel (mit allen optionalen Feldern):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "imageFile": "iVBORw0KGgoAAAANSUhEUgAA...",
  "imageName": "signature.jpg",
  "pages": "1-3",
  "alignX": "Right",
  "alignY": "Bottom",
  "widthInMM": "50",
  "heightInMM": "25",
  "widthInPx": "142",
  "heightInPx": "71",
  "marginXInMM": "20",
  "marginYInMM": "20",
  "marginXInPx": "57",
  "marginYInPx": "57",
  "opacity": "100",
  "showOnlyInPrint": true,
  "isBackground": false,
  "async": true
}

Codebeispiele

Der PDF4me Zeichen 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 für die Unterzeichnung PDF Dokumente:

View C# Sample

PDF Signierfunktionen

Signaturbildsteuerung

Formatunterstützung: JPG, PNG, GIF und andere Standardbildformate
Qualitätserhaltung: Behält die charakteristische Bildqualität und Auflösung bei in PDF Ausgabe
Base64 KodierungSichere Signaturübertragung durch Base64 Kodierung
Flexible Größenanpassung: Sowohl millimeter- als auch pixelbasierte Größenoptionen
Professionelles AuftretenHochwertige Signaturdarstellung mit klarer Sichtbarkeit

Positionierung und Layout

AusrichtungskontrollePräzise horizontale und vertikale Ausrichtungsoptionen
Randeinstellungen: Sowohl millimeter- als auch pixelbasierte Positionierung
Flexible PlatzierungUnterstützung für jede Seitenposition und -ausrichtung
Seitenausrichtung: Auf bestimmte Seiten oder ganze Dokumente anwenden
GrößenkontrolleAnpassbare Abmessungen für optimale Platzierung

Erweiterte Funktionen

Opazitätskontrolle: Einstellbare Transparenz für dezente oder auffällige Unterschriften
HintergrundmodusOption zum Platzieren von Signaturen hinter oder vor dem Inhalt
Drucksteuerung: Signaturen so konfigurieren, dass sie nur im Ausdruck oder nur auf dem Bildschirm angezeigt werden.
Professionelle Ergebnisse: Signaturen erstellen, die die Dokumentenauthentifizierung und -sicherheit verbessern.
Flexible Positionierung: Horizontale und vertikale Ausrichtung mit pixelgenauer Präzision steuern

Branchenspezifische Anwendungsfälle und Anwendungen

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

Anwendungsfälle für Rechts- und Beratungsdienstleistungen

Rechtsdokumentation: Unterschriften auf Rechtsverträge, Vereinbarungen und offizielle Dokumente aufbringen
VertragsunterzeichnungVerträge und Vereinbarungen digital unterzeichnen, um Rechtsgültigkeit zu gewährleisten
Gerichtsdokumente: Digitale Signaturen für Gerichtsdokumente und juristische Dokumente verwenden
Konformitätsanforderungen: Erfüllung der regulatorischen Anforderungen für die Unterzeichnung und Authentifizierung von Dokumenten

Hilfe erhalten

Get Your API Key API Samples Getting Started

Authentifizierung Ihres API Anfrage​

Hauptmerkmale​

REST API Endpunkt​

Unterstützt PDF Signierfunktionen​

Unterstützung für Signaturbilder​

Positionierung und Layout​

Erweiterte Funktionen​

REST API Parameter​

Erforderliche Parameter​

Optionale Parameter​

Ausgabe​

Beispielanfrage​

Kopfzeile​

Nutzlast​

Codebeispiele​

PDF Signierfunktionen​

Signaturbildsteuerung​

Positionierung und Layout​

Erweiterte Funktionen​

Branchenspezifische Anwendungsfälle und Anwendungen​

Hilfe erhalten​

Authentifizierung Ihres API Anfrage

Hauptmerkmale

REST API Endpunkt

Unterstützt PDF Signierfunktionen

Unterstützung für Signaturbilder

Positionierung und Layout

Erweiterte Funktionen

REST API Parameter

Erforderliche Parameter

Optionale Parameter

Ausgabe

Beispielanfrage

Kopfzeile

Nutzlast

Codebeispiele

PDF Signierfunktionen

Signaturbildsteuerung

Positionierung und Layout

Erweiterte Funktionen

Branchenspezifische Anwendungsfälle und Anwendungen

Hilfe erhalten