API PDF per QR code in documenti ed etichette
Renderizza QR code dentro PDF per ricevute, biglietti, etichette, pacchetti di onboarding e processi di ricerca documentale usando JSON Render o template.
/api/v1/pdf/render Inserire QR code in documenti PDF, etichette, ricevute, biglietti o moduli, così gli utenti possono scansionare un link, un identificativo o un token di ricerca controllato dal vostro sistema.
Quando usare questa API
- Il vostro sistema ha un URL, token, ID ordine, ID biglietto o valore di ricerca da codificare.
- Vi serve il QR code disegnato dentro un PDF invece che composto come bitmap esterna.
- Vi servono layout ripetuti basati su QR tramite Template Render.
- Volete un unico percorso API per testo, layout, output PDF e rendering del QR code.
Cosa non sostituisce
- Vi serve da gPdf accorciamento URL, emissione di token di accesso o creazione di link di pagamento.
- Vi servono analytics di scansione o logica di app mobile.
- Vi servono QR code fuori dall'output PDF.
Quale endpoint chiamare
/api/v1/pdf/render
JSON Render è il percorso predefinito per questo flusso.
/api/v1/template-render
Usalo quando il flusso richiede l'API collegata, un contratto di template o una verifica delle capacità.
Request minimo
POST /api/v1/pdf/render - pagina documento con QR code di ricerca.
{
"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
}
]
}
]
}
Cosa gestisce gPdf
- Rendering vettoriale di QR code dentro output PDF.
- Testo, layout e contesto di ricevuta, biglietto, etichetta o documento attorno al QR code.
- Associazione al template per processi QR ripetuti.
- Consegna della risposta PDF tramite le API pubbliche di rendering.
Cosa controlla il tuo sistema
- URL o token codificato, controllo accessi, scadenza, comportamento di redirect e destinazione mobile.
- Test di scansione, percorso utente e regole antifrode.
- Qualsiasi azione di pagamento, biglietto, reso o account avviata dopo la scansione.
Checklist di produzione
- Mantenete gli URL codificati stabili o reindirizzabili per l'intera vita del documento.
- Testate distanza di scansione, contrasto, dimensione e materiale di stampa.
- Evitate di incorporare dati sensibili grezzi direttamente nel contenuto QR.
- Usate request ID e registrate l'oggetto di business collegato a ogni PDF generato.
- Spostate i layout QR stabili in Template Render.
Limiti della promessa
- gPdf renderizza QR code nei PDF; non ospita né protegge la destinazione.
- Il vostro sistema possiede scadenza dei token, redirect, permessi ed esperienza di scansione.
- Un QR code da solo non è un sistema di pagamento o ticketing.
Le pagine con QR code richiedono comunque semantica chiara
Il QR code è solo il vettore visibile. Il processo di produzione dipende dalla destinazione o dal token che ci sta dietro. gPdf disegna il QR code nel PDF; il vostro sistema possiede ciò che accade dopo la scansione.
FAQ
- gPdf genera immagini QR code?
- gPdf renderizza elementi QR code dentro l'output PDF. La risposta pubblica è un PDF, non un servizio di immagini standalone.
- I QR code possono essere usati nei template?
- Sì. Un template può includere campi QR e i sistemi chiamanti possono inviare i dati variabili.
- Chi possiede la destinazione del QR?
- Il vostro sistema possiede URL, token, redirect, permessi e comportamento di scadenza.
- Un QR code può contenere dati sensibili?
- Può codificare ciò che inviate, ma i sistemi di produzione di solito dovrebbero codificare un token di ricerca o un URL invece di dati sensibili grezzi.