Barcodes und Retail
QR Code PDF API für Dokumente und Labels
Rendern Sie QR-Codes in PDFs für Belege, Tickets, Labels, Onboarding-Pakete und Dokumenten-Lookup-Workflows mit JSON Render oder Vorlagen.
PRIMÄRE API JSON Render
ENDPOINT
/api/v1/pdf/render SYSTEME SaaS-Backend / E-Commerce-Backend / Ticketing-Backend / Dokumentenautomatisierungsdienst
Aufgabe im Workflow
Platzieren Sie QR-Codes in PDF-Dokumenten, Labels, Belegen, Tickets oder Formularen, damit Nutzer einen Link, eine Kennung oder ein Lookup-Token scannen können, das Ihr System kontrolliert.
Wann diese API passt
- Ihr System hat eine URL, ein Token, eine Bestell-ID, Ticket-ID oder einen Lookup-Wert, der codiert werden soll.
- Der QR-Code soll in ein PDF gezeichnet werden, nicht als externe Bitmap zusammengesetzt.
- Sie benötigen wiederholte QR-basierte Layouts über Template Render.
- Sie möchten einen API-Pfad für Text, Layout, PDF-Ausgabe und QR-Code-Rendering.
Was sie nicht ersetzt
- Sie benötigen URL-Kürzung, Ausgabe von Zugriffstokens oder Payment-Link-Erstellung durch gPdf.
- Sie benötigen Scanner-Analytics oder Mobile-App-Logik.
- Sie benötigen QR-Codes außerhalb der PDF-Ausgabe.
Welchen Endpoint aufrufen
/api/v1/pdf/render
JSON Render ist der Standardpfad für diesen Workflow.
/api/v1/template-render
Nutzen Sie dies, wenn der Workflow den zugehörigen API-Pfad, einen Template-Vertrag oder eine Capability-Abfrage braucht.
Minimaler Request
POST /api/v1/pdf/render - Dokumentseite mit QR-Lookup-Code.
{
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "Scan to view this document online",
"style": { "font_size": 14, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "qrcode",
"content": "https://example.com/documents/DOC-2026-001",
"x": 20,
"y": 44,
"width": 32,
"height": 32
}
]
}
]
}
Was gPdf übernimmt
- Vektor-QR-Barcode-Rendering innerhalb der PDF-Ausgabe.
- Text-, Layout-, Beleg-, Ticket-, Label- oder Dokumentenkontext rund um den QR-Code.
- Template-Binding für wiederholte QR-Workflows.
- PDF-Antwortzustellung über die öffentlichen Render APIs.
Was Ihr System verantwortet
- Codierte URL oder Token, Zugriffskontrolle, Ablaufzeit, Redirect-Verhalten und mobile Zielseite.
- Scanner-Tests, User Journey und Regeln zur Betrugsprävention.
- Jede Zahlungs-, Ticket-, Retouren- oder Kontoaktion, die nach dem Scan ausgelöst wird.
Produktions-Checkliste
- Halten Sie codierte URLs für die Dokumentlebensdauer stabil oder redirectfähig.
- Testen Sie Scan-Distanz, Kontrast, Größe und Druckmaterial.
- Vermeiden Sie, sensible Rohdaten direkt im QR-Payload einzubetten.
- Nutzen Sie Request IDs und protokollieren Sie das Geschäftsobjekt, das mit jedem generierten PDF verbunden ist.
- Verschieben Sie stabile QR-Layouts in Template Render.
Aussagegrenzen
- gPdf rendert QR-Codes in PDFs; es hostet oder sichert das Ziel nicht.
- Ihr System verantwortet Token-Ablauf, Redirects, Berechtigungen und Scanner-UX.
- Ein QR-Code ist für sich genommen kein Zahlungs- oder Ticketing-System.
QR-Code-Seiten brauchen trotzdem klare Semantik
Der QR-Code ist nur der sichtbare Träger. Der Produktionsworkflow hängt vom Ziel oder Token dahinter ab. gPdf zeichnet den QR-Code in das PDF; Ihr System verantwortet, was nach dem Scan passiert.
FAQ
- Erzeugt gPdf QR-Code-Bilder?
- gPdf rendert QR-Code-Barcode-Elemente innerhalb der PDF-Ausgabe. Die öffentliche Antwort ist ein PDF, kein eigenständiger Bilddienst.
- Können QR-Codes in Vorlagen genutzt werden?
- Ja. Eine Vorlage kann QR-Felder enthalten; Aufrufer senden dann die variablen Payload-Daten.
- Wer verantwortet das QR-Ziel?
- Ihr System verantwortet URLs, Tokens, Redirects, Berechtigungen und Ablaufverhalten.
- Kann ein QR-Code sensible Daten enthalten?
- Er kann alles codieren, was Sie senden. Produktionssysteme sollten jedoch normalerweise ein Lookup-Token oder eine URL statt sensibler Rohdaten codieren.