Barcode dan retail

QR code PDF API untuk dokumen dan label

Render QR code di dalam PDF untuk receipt, tiket, label, paket onboarding, dan workflow lookup dokumen memakai JSON Render atau template.

API UTAMA JSON Render
ENDPOINT /api/v1/pdf/render
SISTEM backend SaaS / backend ecommerce / backend ticketing / layanan automasi dokumen
Pekerjaan yang diselesaikan

Menempatkan QR code ke dokumen PDF, label, receipt, tiket, atau form agar pengguna dapat memindai link, identifier, atau lookup token yang dikendalikan sistem Anda.

Kapan memakai API ini

  • Sistem Anda memiliki URL, token, order ID, ticket ID, atau nilai lookup untuk dikodekan.
  • Anda membutuhkan QR code digambar ke dalam PDF, bukan dikomposisikan sebagai bitmap eksternal.
  • Anda membutuhkan layout berbasis QR yang berulang melalui Template Render.
  • Anda menginginkan satu path API untuk teks, layout, output PDF, dan render QR code.

Apa yang tidak digantikan

  • Anda membutuhkan URL shortening, penerbitan access token, atau pembuatan payment link dari gPdf.
  • Anda membutuhkan analytics scanner atau logika mobile app.
  • Anda membutuhkan QR code di luar output PDF.

Endpoint yang dipanggil

UTAMA

/api/v1/pdf/render

JSON Render adalah jalur default untuk workflow ini.

SEKUNDER 1

/api/v1/template-render

Gunakan saat workflow butuh jalur API terkait, kontrak template, atau capability lookup.

Request minimal

POST /api/v1/pdf/render - halaman dokumen dengan 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
        }
      ]
    }
  ]
}

Yang ditangani gPdf

  • Render barcode QR vektor di dalam output PDF.
  • Konteks teks, layout, receipt, tiket, label, atau dokumen di sekitar QR code.
  • Binding template untuk workflow QR berulang.
  • Delivery respons PDF melalui render API publik.

Yang dikelola sistem Anda

  • URL atau token yang dikodekan, access control, expiry, perilaku redirect, dan tujuan mobile.
  • Scanner testing, user journey, dan aturan pencegahan fraud.
  • Aksi pembayaran, tiket, return, atau akun apa pun yang dipicu setelah scan.

Checklist produksi

  1. Jaga URL yang dikodekan tetap stabil atau redirectable selama umur dokumen.
  2. Uji jarak scan, kontras, ukuran, dan material cetak.
  3. Hindari menanam data sensitif mentah langsung dalam payload QR.
  4. Gunakan request ID dan log objek bisnis yang terkait dengan setiap PDF yang digenerate.
  5. Pindahkan layout QR stabil ke Template Render.

Batas klaim

  • gPdf merender QR code dalam PDF; gPdf tidak meng-host atau mengamankan destination.
  • Sistem Anda memiliki token expiry, redirect, permission, dan scanner UX.
  • QR code bukan sistem pembayaran atau ticketing dengan sendirinya.

Halaman QR code tetap membutuhkan semantik yang jelas

QR code hanya carrier yang terlihat. Workflow production bergantung pada destination atau token di baliknya. gPdf menggambar QR code ke dalam PDF; sistem Anda memiliki apa yang terjadi setelah scan.

FAQ

Apakah gPdf membuat gambar QR code?
gPdf merender elemen barcode QR code di dalam output PDF. Respons publik adalah PDF, bukan layanan gambar standalone.
Bisakah QR code dipakai dalam template?
Ya. Template dapat memuat field QR, dan caller dapat mengirim data payload variabel.
Siapa yang memiliki destination QR?
Sistem Anda memiliki URL, token, redirect, permission, dan perilaku expiry.
Bisakah QR code memuat data sensitif?
QR dapat mengodekan apa pun yang Anda kirim, tetapi sistem production biasanya sebaiknya mengodekan lookup token atau URL, bukan data sensitif mentah.