Barcode ও retail
Document ও label-এর জন্য QR code PDF API
JSON Render বা template ব্যবহার করে receipt, ticket, label, onboarding packet এবং document lookup workflow-এর PDF-এ QR code render করুন।
প্রাথমিক API JSON Render
Endpoint
/api/v1/pdf/render System SaaS backend / ecommerce backend / ticketing backend / document automation service
যে কাজটি করতে হবে
PDF document, label, receipt, ticket বা form-এর ভিতরে QR code বসান, যাতে user আপনার system control করা link, identifier বা lookup token scan করতে পারে।
কখন এই API ব্যবহার করবেন
- Encode করার জন্য আপনার system-এর URL, token, order ID, ticket ID বা lookup value আছে।
- External bitmap হিসেবে composite না করে QR code PDF-এর ভিতরে draw করতে হবে।
- Template Render দিয়ে repeated QR-based layout দরকার।
- Text, layout, PDF output এবং QR code rendering-এর জন্য এক API path চান।
এটি কী replace করে না
- gPdf থেকে URL shortening, access-token issuance বা payment-link creation দরকার।
- Scanner analytics বা mobile app logic দরকার।
- PDF output-এর বাইরে QR code দরকার।
কোন endpoint call করবেন
/api/v1/pdf/render
JSON Render এই workflow-এর default path।
/api/v1/template-render
Workflow-তে related API path, template contract অথবা capabilities lookup দরকার হলে ব্যবহার করুন।
নূন্যতম 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 কী করে
- PDF output-এর ভিতরে vector QR barcode rendering।
- QR code-এর চারপাশে text, layout, receipt, ticket, label বা document context।
- Repeated QR workflow-এর জন্য template binding।
- Public render API দিয়ে PDF response delivery।
আপনার system-এর দায়িত্ব
- Encoded URL বা token, access control, expiry, redirect behavior এবং mobile destination।
- Scanner testing, user journey এবং fraud prevention rule।
- Scan-এর পরে trigger হওয়া payment, ticket, return বা account action।
Production checklist
- Document lifetime-এর জন্য encoded URL stable বা redirectable রাখুন।
- Scan distance, contrast, size এবং print material test করুন।
- QR payload-এ সরাসরি sensitive raw data embed করা এড়ান।
- Request ID ব্যবহার করুন এবং generated PDF-এর সাথে tied business object log করুন।
- Stable QR layout Template Render-এ move করুন।
দাবির সীমা
- gPdf PDF-এ QR code render করে; destination host বা secure করে না।
- Token expiry, redirect, permission এবং scanner UX আপনার system own করে।
- QR code নিজে payment বা ticketing system নয়।
QR code page-এও semantics পরিষ্কার থাকা দরকার
QR code শুধু visible carrier। Production workflow নির্ভর করে এর পেছনের destination বা token-এর ওপর। gPdf PDF-এর ভিতরে QR code আঁকে; scan-এর পরে কী ঘটবে, তা আপনার system own করে।
FAQ
- gPdf কি QR code image generate করে?
- gPdf PDF output-এর ভিতরে QR code barcode element render করে। Public response PDF, standalone image service নয়।
- Template-এ কি QR code ব্যবহার করা যায়?
- হ্যাঁ। Template QR field রাখতে পারে, এবং caller variable payload data পাঠাতে পারে।
- QR destination কে own করে?
- URL, token, redirect, permission এবং expiry behavior আপনার system own করে।
- QR code কি sensitive data রাখতে পারে?
- আপনি যা পাঠান সেটি encode করতে পারে, তবে production system সাধারণত raw sensitive data নয়, lookup token বা URL encode করে।