บาร์โค้ดและค้าปลีก

QR code PDF API สำหรับเอกสารและฉลาก

เรนเดอร์ QR codes ภายใน PDF สำหรับ receipts, tickets, labels, onboarding packets และ document lookup workflows ด้วย JSON Render หรือ templates

PRIMARY API JSON Render
ENDPOINT /api/v1/pdf/render
SYSTEMS SaaS backend / ecommerce backend / ticketing backend / บริการ document automation
งานที่ต้องทำให้เสร็จ

วาง QR codes ลงในเอกสาร PDF, labels, receipts, tickets หรือ forms เพื่อให้ผู้ใช้สแกน link, identifier หรือ lookup token ที่ระบบของคุณควบคุม

ควรใช้ API นี้เมื่อใด

  • ระบบของคุณมี URL, token, order ID, ticket ID หรือ lookup value ที่ต้อง encode
  • คุณต้องการให้ QR code ถูกวาดลงใน PDF แทนการ compose เป็น bitmap ภายนอก
  • คุณต้องการ layout ที่ใช้ QR ซ้ำผ่าน Template Render
  • คุณต้องการ API path เดียวสำหรับ text, layout, PDF output และ QR code rendering

สิ่งที่ไม่ได้ทดแทน

  • คุณต้องการ URL shortening, access-token issuance หรือ payment-link creation จาก gPdf
  • คุณต้องการ scanner analytics หรือ mobile app logic
  • คุณต้องการ QR codes นอก PDF output

ควรเรียก endpoint ใด

PRIMARY

/api/v1/pdf/render

JSON Render คือ path หลักสำหรับเวิร์กโฟลว์นี้.

SECONDARY 1

/api/v1/template-render

ใช้เมื่อเวิร์กโฟลว์ต้องการ API path ที่เกี่ยวข้อง สัญญาเทมเพลต หรือการค้นหา capability.

Minimal request

POST /api/v1/pdf/render - หน้าเอกสารพร้อม 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
        }
      ]
    }
  ]
}

gPdf จัดการอะไร

  • การเรนเดอร์ QR barcode แบบเวกเตอร์ภายใน output PDF
  • text, layout, receipt, ticket, label หรือ document context รอบ QR code
  • template binding สำหรับ QR workflows ที่ใช้ซ้ำ
  • การส่ง PDF response ผ่าน public render APIs

ระบบของคุณรับผิดชอบอะไร

  • encoded URL หรือ token, access control, expiry, redirect behavior และ mobile destination
  • scanner testing, user journey และ fraud prevention rules
  • payment, ticket, return หรือ account action ใด ๆ ที่เกิดหลังการสแกน

Production checklist

  1. รักษา encoded URLs ให้เสถียรหรือ redirectable ตลอดอายุของเอกสาร
  2. ทดสอบระยะสแกน contrast ขนาด และวัสดุพิมพ์
  3. หลีกเลี่ยงการฝัง raw sensitive data ลงใน QR payload โดยตรง
  4. ใช้ request IDs และ log business object ที่ผูกกับ PDF แต่ละไฟล์
  5. ย้าย layout QR ที่เสถียรไปใช้ Template Render

ขอบเขตของ claim

  • gPdf เรนเดอร์ QR codes ใน PDF แต่ไม่ได้ host หรือ secure destination
  • ระบบของคุณเป็นเจ้าของ token expiry, redirects, permissions และ scanner UX
  • QR code ไม่ใช่ payment หรือ ticketing system ด้วยตัวเอง

หน้า QR code ยังต้องมี semantics ที่ชัดเจน

QR code เป็นเพียงตัวพาข้อมูลที่มองเห็นได้ production workflow ขึ้นอยู่กับ destination หรือ token ที่อยู่ข้างหลัง gPdf วาด QR code ลงใน PDF ส่วนระบบของคุณเป็นเจ้าของสิ่งที่เกิดขึ้นหลังการสแกน

FAQ

gPdf สร้างรูป QR code หรือไม่
gPdf เรนเดอร์ QR code barcode elements ภายใน PDF output public response เป็น PDF ไม่ใช่ standalone image service
ใช้ QR codes ใน templates ได้หรือไม่
ได้ เทมเพลตสามารถมี QR fields และ caller ส่ง variable payload data ได้
ใครเป็นเจ้าของ QR destination
ระบบของคุณเป็นเจ้าของ URLs, tokens, redirects, permissions และ expiry behavior
QR code ใส่ sensitive data ได้หรือไม่
มัน encode อะไรก็ได้ที่คุณส่ง แต่ production systems ควร encode lookup token หรือ URL แทน raw sensitive data ในเกือบทุกกรณี