Barcode hinzufügen PDF - QR Code Integration API
PDF4me Barcode hinzufügen PDF ermöglicht Ihnen das Hinzufügen professioneller Barcodes und QR codes Zu PDF Dokumente mit präzisen Steuerungsmöglichkeiten für Positionierung, Größe und Formatierung. API Serviceprozesse PDF Dateien und fügt Barcodes hinzu mithilfe von Base64 Sichere Verschlüsselung für die Übertragung. Mit Unterstützung für über 150 Barcode-Typen, darunter QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417Dank seiner Spezialformate eignet sich diese Lösung ideal für Bestandsverwaltungssysteme, die Automatisierung von Versandetiketten, Dokumentenverfolgungs-Workflows und die Integration von Barcodes in Unternehmen.
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
Hauptmerkmale
- Umfassende Barcode-Unterstützung: Mehr als 150 Barcode-Typen, einschließlich QR codes, Code128, DataMatrix, Aztec, Hanxin, PDF417, Postleitzahlen und branchenspezifische Formate
- Präzise PositionierungssteuerungPlatzieren Sie Barcodes an beliebiger Stelle auf PDF Seiten mit pixelgenauer Präzision unter Verwendung von Millimeter- und Punktmesssystemen
- Erweiterte GrößenoptionenFlexible Barcode-Abmessungen mit automatischer Größenanpassung und benutzerdefinierten Breiten-/Höheneinstellungen für optimale Scanleistung
- Professionelles TextmanagementKonfigurieren Sie die Anzeige, Positionierung (oben/unten) und Sichtbarkeit des Barcode-Textes mit anpassbaren Formatierungsoptionen.
- Opportunität und Transparenz: Passen Sie die Transparenz der Barcodes für Wasserzeicheneffekte, Dokumentenüberlagerungen und eine professionelle Präsentation an.
- Stapelverarbeitung im Unternehmen: Fügen Sie Barcodes zu mehreren Seiten, Dokumenten oder ganzen Dokumentensammlungen mit automatisierten Verarbeitungsworkflows hinzu
REST API Endpunkt
Der PDF4me REST API verwendet Standard HTTP Methoden zur Interaktion mit Ressourcen. Alle Barcode-Operationen werden über einen einzigen Endpunkt durchgeführt:
- Verfahren: POST
- Endpunkt:
/api/v2/addbarcode
Unterstützte Barcode-Typen
Unterstützt über 150 Barcode-Typen für umfassende PDF Integration.
Gängige 1D-Barcodes
- Code128 - Universeller Barcode (max. 255 Zeichen)
- Code39 - Alphanumerischer Barcode (maximal 43 Zeichen)
- EAN13/EAN8 - Einzelhandelsproduktcodes (13/8 Zeichen)
- UPC-A/UPC-E - Nordamerikanischer Einzelhandel (12/8 Zeichen)
Gängige 2D-Barcodes
- QR Code - Mobiles Scannen (max. 4.296 Zeichen)
- DataMatrix - Hochdichte 2D-Grafik (maximal 2.335 Zeichen)
- PDF417 - Große Datenkapazität (maximal 2.710 Zeichen)
- Aztec - Hervorragende Fehlerkorrektur (max. 3.832 Zeichen)
Spezialformate
- Postleitzahlen: USPS, Royal Mail, Australia Post, Deutsche Post
- Gesundheitspflege: HIBC, GS1 DataBar, Pharmacode
- Logistik: MaxiCode, SSCC-18, ITF-14, GS1-128
- QR-Varianten: Micro QR, iQR, rMQR
REST API Parameter
Vollständige Liste der Parameter für die Funktion "Barcode 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* | String | Ausgabe PDF Dateiname mit der Erweiterung .pdf | output.pdf |
| docContent* | Base64 | Der Inhalt der Eingabe PDF Datei kodiert in Base64 | JVBERi... |
| Text* | String | Der im Barcode zu kodierende Text. Die Textlänge hängt vom Barcode-Typ ab. | PDF4me Barcode Sample |
| barcodeType* | String | Barcode-Formattyp. Optionen: qrCode, code128, dataMatrix, aztec, hanxin, pdf417, code39, ean13, ean8, upcA, upcE | qrCode |
| Seiten* | String | Zielseiten (z. B. "1-3", "alle", "1", "1,3,5", "2-5", "1,3,7-10", "2-") | 1-3 |
| alignX* | String | Horizontale Ausrichtung: Links, Center, oder Rechts | Right |
| alignY* | String | Vertikale Ausrichtung: Spitze, Mitte, oder Unten | Bottom |
| hideText* | Boolean | Textbeschriftung für Barcode ausblenden (true = ausblenden, false = Text neben dem Barcode anzeigen) | true |
Optionale Parameter
| Parameter | Typ | Beschreibung | Beispiel |
|---|---|---|---|
| heightInMM | String | Barcodehöhe in Millimetern (0 = automatisch) | 40 |
| widthInMM | String | Barcodebreite in Millimetern (0 = automatisch) | 40 |
| marginXInMM | String | Horizontaler Rand in Millimetern | 20 |
| marginYInMM | String | Vertikaler Rand in Millimetern | 20 |
| heightInPt | String | Barcode-Höhe in Punkten | 113 |
| widthInPt | String | Barcodebreite in Punkten | 113 |
| marginXInPt | String | Horizontaler Rand in Punkten | 57 |
| marginYInPt | String | Vertikaler Rand in Punkten | 57 |
| opacity | Integer | Transparenzgrad (0-100): 0 = unsichtbar, 100 = vollständig undurchsichtig | 100 |
| displayText | String | Textposition: über oder unten | below |
| showOnlyInPrint | Boolean | Nur in der Druckansicht anzeigen (wahr) oder in der Ansicht und im Druckmodus (falsch) | false |
| isTextAbove | Boolean | Text über dem Barcode (wahr) oder darunter (falsch) | false |
| async | 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 Barcode 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 Barcode, kodiert als Base64 Zeichenkette
Anwendungshinweise:
- Extrahieren Sie die
docContentFeld 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/addbarcode/poll/12345-abcde-67890
Abstimmungsverfahren:
- Extrahieren Sie die
LocationHeader 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
docNameUnddocContent(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:
- Ungültige Anfrageparameter
- Fehlende Pflichtfelder
- Ungültig Base64 Kodierung in
docContent - Ungültiger Barcode-Typ
- Ungültige Ausrichtungswerte
- Ungültig oder fehlend API Schlüssel
- API Schlüssel nicht richtig Base64 kodiert in Authorization Überschrift
- Fehlen
AuthorizationGrundlegendÜberschrift
- Serverseitiger Verarbeitungsfehler
- PDF Verarbeitungsfehler
- Fehler bei der Barcode-Generierung
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 verwendenAuthorization: Basic YWJjMTIz
Nutzlast
Einfaches Beispiel (nur Pflichtfelder):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"text": "PDF4me Barcode Sample",
"barcodeType": "qrCode",
"pages": "1-3",
"alignX": "Right",
"alignY": "Bottom",
"hideText": true
}
Erweitertes Beispiel (mit allen optionalen Feldern):
{
"docName": "output.pdf",
"docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
"text": "PDF4me Barcode Sample",
"barcodeType": "qrCode",
"pages": "1-3",
"alignX": "Right",
"alignY": "Bottom",
"hideText": true,
"heightInMM": "40",
"widthInMM": "40",
"marginXInMM": "20",
"marginYInMM": "20",
"heightInPt": "113",
"widthInPt": "113",
"marginXInPt": "57",
"marginYInPt": "57",
"opacity": 100,
"displayText": "below",
"showOnlyInPrint": false,
"isTextAbove": false,
"async": true
}
Codebeispiele
Der PDF4me Barcode 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#
- Java
- JavaScript
- Python
- Salesforce
- Google Script
- n8n
- AWS Lambda
C# (CSharp) Probe
Vollständig C# Implementierung zum Hinzufügen von Barcodes zu PDF Dokumente:
Java Probe
Java Implementierung mit vollständiger Fehlerbehandlung und Antwortverarbeitung:
Python Probe
Python Implementierung mit der Requests-Bibliothek und JSON Handhabung:
Google Script Probe
Google Apps Script Implementierung für Google Workspace Integration:
Branchenspezifische Anwendungsfälle und Anwendungen
- E-commerce & Retail
- Logistics & Shipping
- Healthcare & Medical
- Government & Compliance
- Education & Libraries
- Business & Finance
Anwendungsfälle im E-Commerce und Einzelhandel
- ProduktkatalogeGenerierung von Barcodes für die Bestandsverwaltung und Produktidentifizierung
- PreisschilderDynamische Preisgestaltung mit Barcode-Integration für automatisierten Checkout
- Auftragsverfolgung: Fügen Sie Sendungsverfolgungscodes zu den Versanddokumenten hinzu, um Pakete in Echtzeit zu verfolgen.
- InventarsystemeMassenhafte Barcode-Generierung für Lagerverwaltung und Bestandskontrolle
Anwendungsfälle im Bereich Logistik & Versand
- Versandetiketten: Fügen Sie den Lieferdokumenten Tracking-Barcodes hinzu, um die Rückverfolgbarkeit der Pakete zu gewährleisten.
- Paketverfolgung: Generierung eindeutiger Kennungen für jede Sendung entlang der gesamten Lieferkette
- Lagerverwaltung: Barcodes für Lagerplätze und Produktidentifizierung erstellen
- Lieferkette: Verfolgen Sie Produkte mithilfe eingebetteter Codes durch das gesamte Vertriebsnetz.
Anwendungsfälle im Gesundheitswesen und in der Medizin
- Patientenakten: Fügen Sie Barcodes hinzu, um Patienten schnell zu identifizieren und auf ihre Krankengeschichte zuzugreifen
- MedikamentenverabreichungGenerierung von Barcodes zur Medikamentenverfolgung und Dosierungsprüfung
- Medizinische GeräteGeräte mit Wartungs-Barcodes für das Anlagenmanagement kennzeichnen
- Laborergebnisse: Fügen Sie Barcodes zu Testergebnisdokumenten hinzu, um eine sichere Verknüpfung von Patientendaten zu gewährleisten.
Anwendungsfälle im Bereich Regierung und Compliance
- AusweisdokumenteFügen Sie Führerscheinen und Reisepässen Sicherheits-Barcodes zur Überprüfung hinzu.
- Steuerdokumente: Generierung von Tracking-Codes für Steuerformulare und Überwachung der Einhaltung der Vorschriften
- Konformitätsformulare: Barcodes für die behördliche Nachverfolgung und Prüfprotokollierung hinzufügen
- Öffentliche Aufzeichnungen: Erstellung durchsuchbarer Dokumentenkennungen für Regierungsdatenbanken
Anwendungsfälle im Bildungs- und Bibliotheksbereich
- StudentenausweiseGenerierung von Barcodes zur Studierendenidentifizierung und Campus-Zutrittskontrolle
- Bibliothekssysteme: Bücher und Ressourcen mit Barcodes für automatisierte Ausleihsysteme versehen
- Prüfungsunterlagen: Erstellung eindeutiger Kennungen für Testdokumente und akademische Integrität
- Campusdienste: Erfassung des Geräte- und Ressourcenverbrauchs in allen Bildungseinrichtungen
Anwendungsfälle im Bereich Wirtschaft und Finanzen
- Rechnungsverarbeitung: Barcodes für die automatisierte Rechnungsverarbeitung und Zahlungsabwicklung hinzufügen
- Dokumentenmanagement: Erstellen Sie eindeutige Kennungen für Geschäftsdokumente und Datensätze
- AnlagenverfolgungGenerieren von Barcodes für Ausrüstung und Anlagen in verschiedenen Organisationen
- Prüfprotokolle: Tracking-Codes für Compliance-Dokumentation und Finanzaufzeichnungen hinzufügen