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।

সহায়ক 1

/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

  1. Document lifetime-এর জন্য encoded URL stable বা redirectable রাখুন।
  2. Scan distance, contrast, size এবং print material test করুন।
  3. QR payload-এ সরাসরি sensitive raw data embed করা এড়ান।
  4. Request ID ব্যবহার করুন এবং generated PDF-এর সাথে tied business object log করুন।
  5. 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 করে।