Membuat Kod QR Secara Pukal untuk Pembungkusan Produk Melalui API

Satu QR untuk semua produk sudah cukup untuk brosur, tetapi bukan untuk pembungkusan. Pengilang mahu setiap SKU, malah setiap nombor siri, mempunyai QR sendiri supaya ia boleh menavigasi ke halaman produk yang betul, mengaktifkan jaminan atau mengesahkan ketulenan. Mencipta beribu-ribu QR secara manual adalah mustahil; melalui API, ia adalah kerja satu skrip.

Mengapa QR dinamik untuk pembungkusan

Pembungkusan dicetak sekali dan diedarkan selama bertahun-tahun. Dengan QR dinamik, destinasi setiap QR boleh diubah pada bila-bila masa: hari ini ke halaman produk, semasa penarikan balik produk ke pengumuman rasmi, ketika promosi ke halaman kupon. Setiap imbasan juga direkodkan, jadi anda mengetahui produk yang diimbas, di bandar mana dan bila.

Reka bentuk skema alias

Sebelum membuat, tentukan corak alias deterministik, kerana alias ialah kunci yang menghubungkan QR fizikal kepada data anda:

• Setiap SKU: p-ab1234. Cukup untuk halaman produk dan promosi.
• Setiap nombor siri: s-ab1234-000981. Diperlukan untuk jaminan dan pengesahan ketulenan.
• Setiap kumpulan pengeluaran: b-2026w31-ab1234. Kompromi antara keduanya untuk penjejakan pengedaran.

Alias deterministik turut menjadikan skrip idempoten: jika dijalankan semula, alias sedia ada ditolak oleh API dan anda tahu QR sudah dibuat. Peraturan penulisan alias dibincangkan dalam artikel alias tersuai.

Titik akhir digunakan

POST /api/qr/add terima type (link, text, vcard, wifi dan lain-lain), data yang mengandungi destinasi, name sebagai label dalaman, custom untuk alias pautan pendek di belakangnya, serta pilihan reka bentuk seperti warna, logo, bingkai dan format output (png, svg, pdf). Respons mengandungi ID QR, pautan pendek dan URL fail imej. Parameter lengkap ada dalam dokumentasi pembangun.

Skrip kelompok

Beberapa nota pada skrip di atas:

• Jeda 1,1 saat memastikan kadar kekal di bawah 60 permintaan seminit (pelan Pro). Pelan Business membenarkan 300 seminit, jadi jeda boleh dipendekkan. Penjelasan lengkap dalam artikel had kadar dan pengendalian ralat.
• Simpan hasilnya ke fail secara berperingkat, supaya jika skrip berhenti di tengah, anda boleh meneruskan dari baris terakhir.
• Minta format SVG untuk cetakan; vektor kekal tajam pada label 1,5 cm mahupun poster. Sebab teknikal diterangkan dalam artikel reka bentuk kod QR dengan logo.
• Tambahkan reka bentuk seragam (warna jenama, logo kecil) melalui parameter, supaya semua QR konsisten tanpa pengeditan manual.

Alternatif tanpa kod

Kalau beratus, bukan beribu, menu QR pukal dalam papan pemuka menerima fail CSV yang mengandungi nama, destinasi dan lajur alias, kemudian menjana arkib ZIP yang mengandungi semua imej. Ciri ini tersedia pada pelan Pro dan ke atas (lihat harga).

Hantar kepada pihak pencetak

• Pihak pencetak biasanya menerima data berubah dalam bentuk folder SVG/PDF yang dinamakan mengikut SKU atau nombor siri, berserta CSV pemetaan. Pastikan nama fail sepadan tepat dengan alias.
• Sertakan sampel cetakan untuk ujian imbasan sebelum pengeluaran penuh. Piawaian saiz dan quiet zone merujuk kepada ISO/IEC 18004.
• Arahkan semua QR ke halaman "akan datang" dahulu; tukar destinasi pukal melalui API apabila produk mula dijual.

Membaca data imbasan

Oleh sebab setiap QR mempunyai alias sendiri, statistik boleh diambil mengikut produk melalui GET /api/url/{id} atau dilihat dalam papan pemuka. Kumpulkan QR dalam Kempen mengikut barisan produk untuk melihat jumlah gabungan. Anda juga boleh menghantar imbasan masa nyata ke sistem gudang atau CRM melalui webhooks, contohnya untuk mengaktifkan jaminan automatik apabila pengguna mengimbas buat kali pertama.

Soalan lazim

Berapa lama masa yang diambil untuk membuat seribu QR melalui API?

Dengan pelan Pro dihadkan pada 60 permintaan seminit, itu kira-kira 17 minit. Dengan pelan Business membenarkan 300 permintaan seminit, kira-kira 4 minit. Jalankan skrip di latar belakang dan simpan hasilnya secara berperingkat.

Bolehkah destinasi semua QR pukal diubah serentak?

boleh. Oleh kerana setiap QR mempunyai ID dan alias, skrip yang sama boleh memanggil titik akhir kemas kini untuk menggantikan destinasi secara pukal, contohnya apabila produk menukar halaman atau apabila kempen baharu bermula.

Format fail apakah yang diterima pihak pencetak untuk data berubah?

Biasanya folder itu mengandungi SVG atau PDF yang dinamakan sempena nombor siri, serta CSV pemetaan. Pastikan nama fail betul-betul sepadan dengan alias untuk mengelakkan padanan yang salah dan sertakan sampel cetakan untuk imbasan ujian.

Bolehkah imbasan nombor siri digunakan untuk mengesahkan kesahihan?

Boleh digunakan sebagai lapisan awal. Imbasan yang muncul dari banyak bandar berbeza untuk satu nombor siri menunjukkan kemungkinan pemalsuan. Untuk pengesahan yang kukuh, gabungkannya dengan sistem pengaktifan di sisi aplikasi anda.