API kode QR
QR Code Crafter API membuat aset QR statis melalui endpoint Netlify Function publik. Payload seperti URL, Wi-Fi, vCard, event, lokasi, pembayaran, app store, social profile, dan teks biasa dapat diubah menjadi file QR yang siap dipakai.
Agent dapat membaca kontrak dari OpenAPI, WebMCP, ai.txt, llms.txt, dan runtime tools di halaman live. Integrasi tidak perlu menebak parameter atau membaca form visual secara manual.
OpenAPI GenerateQrRequest: x-agent-recipes. WebMCP: api.agentRecipes. Payment content: PhonePe-compatible UPI, Swiss QR-bill, SEPA/GiroCode, iDEAL, MobilePay/Vipps, QRIS.
Untuk satu file QR, panggil /.netlify/functions/generate-qr dengan GET atau POST. Gunakan POST JSON untuk payload panjang, vCard, event, Wi-Fi, data logo, dan workflow yang membutuhkan metadata file.
Untuk banyak file, panggil /.netlify/functions/generate-qr-bulk dengan CSV atau row objects. Endpoint ini mengembalikan ZIP berisi file QR, manifest.csv, dan manifest.json, dengan batas publik 50 baris agar otomatisasi tetap aman.
API ini menghasilkan static QR asset, bukan dashboard scan dinamis. Jika kampanye perlu reporting, buat URL UTM atau redirect milik sendiri terlebih dahulu, lalu encode tujuan final itu sebagai QR statis.
Tinjauan fitur independen
Ditinjau pada
Panduan
Endpoint satu QR
GET query atau POST JSON ke generate-qr untuk membuat satu aset QR. Respons POST menyertakan base64 data, filename, content type, extension, width, height, dan unit.
Dokumen discovery untuk agent
/.well-known/openapi.json, /openapi.yaml, /.well-known/webmcp.json, /ai.txt, dan /llms.txt menjelaskan schema, batas, format, dan contoh request.
Enam format ekspor
Request yang sama dapat menghasilkan SVG, PNG, JPG, WebP, PDF, atau EPS. Gunakan SVG/PDF/EPS untuk print handoff dan PNG/WebP untuk publikasi digital.
Bulk ZIP generation
Endpoint bulk memproses sampai 50 rows dan mengembalikan arsip ZIP dengan file QR serta manifest yang bisa dibaca sistem downstream.
Metadata mudah diverifikasi
Agent dapat memeriksa byteLength, width, height, unit, extension, contentType, fileCount, dan manifest sebelum menyimpan atau mengirim file QR.
Model statis yang minim dependensi
File QR menyimpan payload langsung di pattern. Tidak ada redirect wajib dari penyedia QR, quota scan, atau dashboard akun yang harus tetap aktif agar QR terbaca.
Opsi request API QR code
| Opsi | Nilai yang diterima | Kegunaan |
|---|---|---|
| Endpoint satu file | GET atau POST /.netlify/functions/generate-qr | Membuat satu aset QR statis dari payload final. |
| Endpoint bulk | POST /.netlify/functions/generate-qr-bulk | Membuat ZIP dari CSV rows atau JSON row objects. |
| Batas bulk | 1-50 rows per request | Menjaga browser agents dan public automation tetap bounded. |
| format | svg, png, jpg, webp, pdf, eps | Memilih tipe aset untuk web, dokumen, desain, atau print. |
| size | 256-4096 | Mengatur dimensi untuk raster image dan layout export. |
| errorCorrectionLevel | L, M, Q, H | Pilih H untuk logo, print, atau kondisi scan yang lebih berat. |
| Metadata respons | contentType, extension, byteLength, width, height, unit | Memastikan file yang tersimpan sesuai dengan request. |
| Dokumen discovery | OpenAPI, WebMCP, ai.txt, llms.txt | Membantu agent dan API client membaca parameter tanpa guessing. |
| Campaign reporting | Encode URL UTM atau redirect yang Anda kontrol | Static QR tidak membuat scan dashboard dari provider; reporting berasal dari destination workflow. |
Cara agent memanggil QR code API
Workflow agent yang stabil dimulai dari discovery file, membangun payload, memilih format, lalu memverifikasi metadata sebelum file dipakai downstream.
Mulai dari discovery
Baca /ai.txt, /llms.txt, atau /.well-known/openapi.json agar client memakai endpoint, schema, contoh request, dan supported formats yang terbaru.
Pakai POST untuk otomatisasi
POST JSON menghindari batas query string untuk URL panjang, vCard, event, Wi-Fi, payment payload, dan logo data URL.
Pakai GET untuk download langsung
GET mengembalikan binary asset langsung dan mengekspos header X-QR-Width, X-QR-Height, X-QR-Unit, serta X-QR-Bytes.
Verifikasi file yang disimpan
Cek contentType, extension, byteLength, width, height, dan unit sebelum mengunggah file ke CMS, Google Drive, print workflow, atau agent lain.
Workflow bulk QR generation
Bulk endpoint cocok untuk label aset, ruang kelas, packaging, menu, event badges, campaign variants, dan file QR yang dibuat dari data terstruktur.
Kirim CSV atau row objects
Gunakan CSV filename,value atau JSON rows dengan value dan optional filename. Endpoint menormalkan nama file dan menolak row kosong atau terlalu besar.
Pilih satu format bersama
Set SVG, PNG, JPG, WebP, PDF, atau EPS sekali untuk batch. SVG cocok untuk automation volume tinggi; PDF atau EPS cocok untuk print handoff.
Minta ZIP saat perlu arsip langsung
Header Accept: application/zip mengembalikan ZIP binary. Respons JSON tersedia jika agent perlu base64 ZIP data, byteLength, fileCount, dan manifest details.
Gunakan manifest untuk audit
manifest.csv dan manifest.json memetakan source rows ke filename, status, dan byte counts agar downstream system bisa menelusuri hasil batch.
Payload statis yang didukung
API meng-encode payload persis seperti yang dikirim. Validasi payload di workflow Anda sebelum file QR dibuat dan dipublikasikan.
Link marketing dan konten
Encode HTTPS URL, campaign URL dengan UTM, app store page, social profile, menu, PDF landing page, dan Google review link.
Aksi perangkat
Encode Wi-Fi strings, mailto links, SMS actions, phone links, WhatsApp links, calendar events, map coordinates, dan vCard contact payloads.
Payload pembayaran
Encode PIX EMV, UPI URI, dan crypto wallet URI setelah recipient, amount, memo, dan currency divalidasi di sistem Anda.
Output desain dan print
Gunakan SVG, PDF, atau EPS untuk artwork produksi; gunakan PNG, JPG, atau WebP untuk preview, dokumen, email, dan web publishing.
Checklist integrasi agent
- Baca /ai.txt atau /.well-known/openapi.json sebelum membuat request.
- Gunakan POST JSON untuk vCard, event, Wi-Fi, payment, logo, dan payload panjang.
- Gunakan endpoint bulk hanya untuk batch sampai 50 rows.
- Kirim Accept: application/zip ketika agent membutuhkan ZIP binary langsung.
- Set User-Agent yang deskriptif untuk automated integration.
- Hormati header Retry-After pada respons 429 dan 503.
- Decode base64 data dari POST response dan simpan dengan extension yang dikembalikan.
- Verifikasi byteLength, dimensions, fileCount, dan manifest metadata sebelum handoff.
- Jalankan smoke test untuk setiap content payload dan export format sebelum production use.
- Untuk tracking kampanye, encode URL UTM atau redirect milik sendiri sebelum QR dibuat.
Panduan: cetak
API kode QR harus diperlakukan sebagai alur kerja publikasi, bukan sekadar gambar yang dibuat. Pastikan tujuan, pilih format ekspor, uji aset akhir, dan tetapkan penanggung jawab sebelum kode muncul dalam materi publik.
Sebelum menggunakan API kode QR pada materi cetak, kemasan, papan informasi, email, dokumen, aplikasi, atau otomatisasi, simpan catatan rilis singkat berisi nilai yang dikodekan, nama file, format ekspor, penempatan, penanggung jawab, dan hasil pengujian. Catatan ini memungkinkan perbaikan di kemudian hari.
kode QR URL: HTTPS
Untuk API kode QR, pastikan URL yang dikodekan, detail kontak, instruksi pembayaran, file, atau tindakan aplikasi sudah tepat, dikelola oleh tim yang benar, tersedia di perangkat seluler, dan sesuai bagi orang yang mungkin memindai kode tersebut.
Pilih format
Simpan master SVG, PDF, atau EPS untuk cetak, kemasan, tanda, dan alat desain. Gunakan PNG, JPG, WebP, atau SVG untuk situs web, email, dokumen, dan penempatan digital, lalu hindari kompresi tak terduga pada kode akhir.
pemindaian
Sebelum rilis, pindai pratinjau peramban, file yang diunduh, tata letak yang ditempatkan, PDF yang diekspor, unggahan CMS, pratinjau email, dan bukti fisik dari jarak, sudut, pencahayaan, serta perangkat yang realistis.
Perusahaan
Catat penanggung jawab QR, tujuan, file sumber, format ekspor, penempatan, tanggal terbit, perangkat uji, tanggal peninjauan, dan pemicu penggantian agar kode QR statis yang digunakan dalam jangka panjang tetap tepercaya.
API kode QR
Saat banyak file QR diperlukan, gunakan penamaan yang konsisten, pemeriksaan manifes, parameter OpenAPI atau WebMCP, dan validasi format keluaran sebelum menyerahkan aset kepada tim desain, cetak, atau konten.
kode QR statis vs dinamis
Tinjau API kode QR setelah perubahan kampanye, perubahan merek, perpindahan domain, pembaruan detail pembayaran, perubahan toko aplikasi, migrasi dokumen, atau perubahan analitik agar kode QR publik tidak mengarah ke tujuan yang usang atau tidak aman.
Masukan
Tambahkan teks tujuan yang mudah dibaca, URL singkat, kontak dukungan, atau instruksi cetak ketika pemindaian sangat penting bagi kegiatan, sensitif terhadap aksesibilitas, atau kemungkinan dilakukan dengan konektivitas yang buruk.
Aksesibilitas
Letakkan teks di dekat kode yang menjelaskan tindakan pemindaian, pertahankan kontras tinggi, hindari penempatan yang terlalu kecil, dan pastikan tujuan berfungsi dengan peramban seluler, pembaca layar, pengaturan gerakan berkurang, serta navigasi keyboard.
Generate QR code lewat API
- 1
Pilih single atau bulk
Gunakan generate-qr untuk satu aset, atau generate-qr-bulk untuk ZIP berisi banyak static QR files.
- 2
Bangun payload final
Siapkan URL, Wi-Fi string, vCard, event, payment URI, text, CSV, atau row objects persis seperti yang harus dibaca scanner.
- 3
Pilih format output
Pilih SVG/PDF/EPS untuk print dan desain; pilih PNG/JPG/WebP untuk digital publishing dan preview.
- 4
Verifikasi respons
Konfirmasi success, content type, byte length, dimensions, extension, dan ZIP manifest sebelum file disimpan.
- 5
Tes scan di konteks akhir
Scan file setelah masuk ke layout final, CMS upload, dokumen, atau proof print agar asset hasil otomatisasi tetap terbaca.
FAQ
Endpoint QR Code Crafter API apa?
Gunakan /.netlify/functions/generate-qr dengan GET query atau POST JSON untuk satu QR code. Gunakan /.netlify/functions/generate-qr-bulk untuk ZIP berisi sampai 50 QR files.
Apakah API bisa membuat QR codes secara bulk?
Ya. Kirim CSV rows atau JSON row objects ke endpoint bulk. Respons bisa berupa JSON dengan base64 ZIP data atau application/zip langsung jika request memakai Accept: application/zip.
Apakah API membutuhkan akun?
Public generation tersedia tanpa akun kecuali deployment mengaktifkan API key enforcement. Jika Anda memiliki key, kirim X-Agent-Api-Key dan tangani respons 401.
Format file apa saja yang bisa dikembalikan API?
Kontrak publik mendukung SVG, PNG, JPG, WebP, PDF, dan EPS.
Bisakah browser agent memakai WebMCP?
WebMCP adalah standar yang masih diusulkan dan hanya bekerja di tab browser atau webview terlihat yang mendukungnya. Periksa alat generate_qr dan generate_bulk_qr yang terdaftar pada halaman saat ini; manifest saja tidak membuat alat dapat dipanggil. Klien headless dan sisi server sebaiknya memakai endpoint HTTP OpenAPI.
Apakah API membuat dynamic tracking QR codes?
Tidak. API membuat static QR assets. Untuk mengukur kampanye, encode URL dengan UTM atau redirect yang Anda kontrol sebelum membuat QR code.
API kode QR: QR code generator API?
API kode QR: QR code generator API. API QR code generator. qrcode API. QR API. generate QR code API. SVG, PNG, JPG, WebP, PDF, EPS.