Barcodes और retail
Documents और labels के लिए QR code PDF API
JSON Render या templates से receipts, tickets, labels, onboarding packets और document lookup workflows के लिए PDFs के अंदर QR codes render करें.
PRIMARY API JSON Render
ENDPOINT
/api/v1/pdf/render SYSTEMS SaaS backend / ecommerce backend / ticketing backend / document automation service
काम जो पूरा करना है
PDF documents, labels, receipts, tickets या forms में QR codes place करें, ताकि users आपके system द्वारा controlled link, identifier या lookup token scan कर सकें.
यह API कब इस्तेमाल करें
- आपके system के पास encode करने के लिए URL, token, order ID, ticket ID या lookup value है.
- आप external bitmap composite करने के बजाय QR code को PDF में draw करना चाहते हैं.
- Template Render से repeated QR-based layouts चाहिए.
- Text, layout, PDF output और QR code rendering के लिए one API path चाहिए.
यह क्या replace नहीं करता
- आपको gPdf से URL shortening, access-token issuance या payment-link creation चाहिए.
- आपको scanner analytics या mobile app logic चाहिए.
- आपको PDF output से बाहर QR codes चाहिए.
कौन सा endpoint call करें
/api/v1/pdf/render
JSON Render इस workflow का default path है।
/api/v1/template-render
जब workflow को related API path, template contract या capabilities lookup चाहिए, तब इसका उपयोग करें।
Minimal request
POST /api/v1/pdf/render - QR lookup code वाला document page.
{
"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
}
]
}
]
}
gPdf क्या handle करता है
- PDF output के अंदर vector QR barcode rendering.
- QR code के around text, layout, receipt, ticket, label या document context.
- Repeated QR workflows के लिए template binding.
- Public render APIs से PDF response delivery.
आपका system क्या संभालता है
- Encoded URL या token, access control, expiry, redirect behavior और mobile destination.
- Scanner testing, user journey और fraud prevention rules.
- Scan के बाद trigger होने वाला payment, ticket, return या account action.
Production checklist
- Document lifetime के लिए encoded URLs को stable या redirectable रखें.
- Scan distance, contrast, size और print material test करें.
- Sensitive raw data को directly QR payload में embed करने से बचें.
- Request IDs use करें और generated PDF से tied business object log करें.
- Stable QR layouts को Template Render में move करें.
Claim boundaries
- gPdf PDFs में QR codes render करता है; destination को host या secure नहीं करता.
- Token expiry, redirects, permissions और scanner UX आपका system own करता है.
- QR code अपने आप payment या ticketing system नहीं है.
QR code pages को भी clear semantics चाहिए
QR code सिर्फ visible carrier है. Production workflow उसके पीछे destination या token पर depend करता है. gPdf QR code को PDF में draw करता है; scan के बाद क्या होता है, वह आपका system own करता है.
FAQ
- क्या gPdf QR code images generate करता है?
- gPdf PDF output के अंदर QR code barcode elements render करता है. Public response PDF है, standalone image service नहीं.
- क्या QR codes templates में use हो सकते हैं?
- हाँ. Template में QR fields हो सकते हैं, और callers variable payload data भेज सकते हैं.
- QR destination कौन own करता है?
- URLs, tokens, redirects, permissions और expiry behavior आपका system own करता है.
- क्या QR code sensitive data रख सकता है?
- यह वही encode कर सकता है जो आप भेजते हैं, लेकिन production systems को आम तौर पर raw sensitive data के बजाय lookup token या URL encode करना चाहिए.