Füge einen Rand hinzu zu PDF - Layout-Formatierer API

PDF4me Füge einen Rand hinzu zu PDF ermöglicht es Ihnen, benutzerdefinierte Ränder an jeder Seite eines PDF Dokument. Dieses API Serviceprozesse PDF Dateien und fügt Ränder in Millimetern hinzu, wobei die Seitengröße entsprechend angepasst wird, um die Ränder zu berücksichtigen. 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 die Dokumentformatierung, Druckvorbereitung und die Gewährleistung einheitlicher Seitenlayouts für professionelle Dokumente.

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

• Individuelle Margenkontrolle: Legen Sie unabhängig voneinander unterschiedliche Ränder für oben, unten, links und rechts fest.
• MillimetergenauAlle Ränder sind in Millimetern angegeben (Bereich 0-100).
• SeitengrößenanpassungDie Seitengröße wird automatisch an die hinzugefügten Ränder angepasst.
• Dokumentenerhaltung: Behält den Originalinhalt bei und passt gleichzeitig das Layout an
• 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 Margin-Addierungsoperationen werden über einen einzigen Endpunkt durchgeführt:

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

REST API Parameter

Vollständige Liste der Parameter für die Funktion "Rand hinzufügen zu" 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...

Optionale Parameter

Parameter	Typ	Beschreibung	Beispiel
linker Rand	Integer	Linker Rand in Millimetern (0–100). Falls nicht angegeben, wird kein linker Rand hinzugefügt.	20
marginRight	Integer	Rechter Rand in Millimetern (0–100). Falls nicht angegeben, wird kein rechter Rand hinzugefügt.	20
marginTop	Integer	Oberer Rand in Millimetern (0–100). Falls nicht angegeben, wird kein oberer Rand hinzugefügt.	25
unterer Rand	Integer	Unterer Rand in Millimetern (0–100). Falls nicht angegeben, wird kein unterer Rand hinzugefügt.	25
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 Füge einen Rand hinzu zu 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

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ügten Rändern, 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

Asynchronous Processing

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/AddMargin/poll/12345-abcde-67890

Abstimmungsverfahren:

1. Extrahieren Sie die Location Header der 202-Antwort
2. Befragen Sie die URL Verwendung GET Anfragen
3. Nehmen Sie so lange an der Umfrage teil, bis Sie eine Antwort erhalten. 200 OK Status
4. 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
}

Error Responses

Fehlermeldungen

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

400 Bad Request

• Ungültige Anfrageparameter
• Fehlende Pflichtfelder (docContent, docName)
• Ungültig Base64 Kodierung in docContent
• Ungültige Margenwerte (müssen ganze Zahlen zwischen 0 und 100 sein)

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 bei der Margenaddition

Fehlerantwortformat:

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

Response Format Details

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=="
}

Erweitertes Beispiel (mit allen optionalen Feldern):

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "marginLeft": 20,
  "marginRight": 20,
  "marginTop": 25,
  "marginBottom": 25,
  "async": true
}

Codebeispiele

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

C#

C# (CSharp) Probe

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

View C# Sample

Java

Java Probe

Java Implementierung mit vollständiger Fehlerbehandlung und Antwortverarbeitung:

View Java Sample

JavaScript

JavaScript Probe

Node.js und browserkompatibel JavaScript Implementierung:

View JavaScript Sample

Python

Python Probe

Python Implementierung mit der Requests-Bibliothek und JSON Handhabung:

View Python Sample

Salesforce

Salesforce Probe

Salesforce Implementierung mit Apex Und HTTP Rufe:

View Salesforce Sample

n8n

n8n Probe

n8n Workflow-Implementierung mit HTTP Anforderungsknoten:

View n8n Sample

Google Script

Google Script Probe

Google Apps Script Implementierung mit UrlFetchApp:

View Google Script Sample

AWS Lambda

AWS Lambda Probe

AWS Lambda Implementierung mit Node.js Und API Gateway:

View AWS Lambda Sample

PDF Margenmerkmale

Margenkontrolle

• Individuelle Kontrolle: Legen Sie für jede Seite des Dokuments unterschiedliche Ränder fest (oben, unten, links, rechts).
• MillimetergenauAlle Ränder sind in Millimetern angegeben, mit einem Bereich von 0-100.
• SeitengrößenanpassungDie Seitengröße wird automatisch an die hinzugefügten Ränder angepasst.
• Layouterhaltung: Dokumentstruktur beibehalten und gleichzeitig die Ränder anpassen

Dokumentenoptimierung

• Druckoptimierung: Sicherstellen, dass Dokumente auf verschiedenen Papiergrößen korrekt gedruckt werden.
• Professionelle Formatierung: Einheitliche Dokumentenlayouts für alle Teams erstellen
• InhaltserhaltungOriginal PDF Der Inhalt bleibt erhalten, während Ränder hinzugefügt werden.

Branchenspezifische Anwendungsfälle und Anwendungen

Legal & Professional Services

Anwendungsfälle für Rechts- und Beratungsdienstleistungen

• RechtsdokumenteSicherstellen der Einhaltung der Formatierungsstandards für Rechtsdokumente
• Vertragsgestaltung: Verträge und Vereinbarungen mit angemessenen Rändern formatieren
• Gerichtsdokumente: Gerichtsdokumente unter Einhaltung der Standardrandvorgaben vorbereiten
• Konformitätsdokumentation: Konformitätsdokumente so formatieren, dass sie den regulatorischen Standards entsprechen

Education & Research

Anwendungsfälle in Bildung und Forschung

• Wissenschaftliche Arbeiten: Formatieren Sie Forschungsarbeiten und Abschlussarbeiten so, dass sie den Veröffentlichungsanforderungen entsprechen.
• ForschungsdokumenteFormatieren Sie Forschungsarbeiten mit angemessenen Rändern für die Veröffentlichung.
• Formatierung der Abschlussarbeit: Formatieren Sie Abschlussarbeiten und Dissertationen so, dass sie den akademischen Standards entsprechen.
• Lehrmaterialien: Formatieren Sie Bildungsdokumente mit einheitlichen Rändern

Business & Enterprise

Anwendungsfälle für Unternehmen und Organisationen

• DokumentformatierungStandardisierung der Ränder in allen Unternehmensdokumenten
• GeschäftsberichteErstellen Sie professionelle Berichte mit einheitlichem Layout
• Präsentationsmaterialien: Visuelle Attraktivität von Präsentationsdokumenten steigern
• Unternehmensdokumentation: Unternehmensdokumente mit Standardrändern formatieren

Publishing & Printing

Anwendungsfälle im Bereich Verlagswesen und Druck

• Druckvorbereitung: PDFs für spezifische Druckanforderungen optimieren
• Buchformatierung: Bücher und Publikationen mit angemessenen Rändern formatieren
• Magazinlayout: Magazinlayouts mit Standardrändern erstellen
• DruckproduktionDokumente für die Druckproduktion optimieren

Hilfe erhalten

Get Your API KeyAPI SamplesGetting Started