API Pembuat Kode QR

Hasilkan gambar kode QR dengan menambahkan .qr.png ke tautan pendek Linkly apa pun. Tidak diperlukan autentikasi atau kunci API.

Gambar dikembalikan sebagai PNG dengan semua gaya kode QR yang tersimpan diterapkan, termasuk warna khusus, pola titik, gaya mata, dan logo.

Penggunaan dasar

Tambahkan .qr.png ke tautan pendek Linkly apa pun:

https://linkly.link/2W6Z9.qr.png

Ini mengembalikan gambar PNG 1024x1024 dari kode QR. Jika Anda telah menyesuaikan warna, gaya, atau logo kode QR di Linkly, gaya tersebut akan diterapkan secara otomatis.

Contoh

Sematkan kode QR di halaman HTML:

<img src="https://linkly.link/2W6Z9.qr.png" alt="QR Code" />

Atau gunakan dalam template email, PDF, atau sistem apa pun yang mendukung URL gambar.

Parameter gaya

Lewatkan parameter kueri untuk mengesampingkan gaya QR yang tersimpan di tautan atau mengubah ukuran gambar:

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

Catatan: warna heksadesimal harus URL-encoded — gunakan %23 sebagai ganti # (misalnya %23ff0000 untuk #ff0000).

Dimensi logo secara otomatis diskalakan agar sesuai dengan ukuran gambar yang diminta.

quietZone menambahkan padding ruang kosong di sekitar seluruh kode QR, diisi dengan bgColor. Ini berguna saat mencetak kode QR di latar belakang gelap — tanpanya, mata positioning duduk flush terhadap tepi dan mungkin tidak dapat dipindai dengan andal. Misalnya, quietZone=50&bgColor=%23ffffff menambahkan batas putih 50 piksel.

Menetapkan gaya melalui Link API

Anda dapat menyimpan gaya kode QR ke tautan saat membuatnya atau memperbaruinya melalui Link Shortening API. Lewatkan objek JSON qr_styles dengan salah satu kunci gaya yang tercantum di atas:

{
  "api_key": "your_api_key",
  "workspace_id": 1234,
  "url": "https://example.com",
  "qr_styles": {
    "fgColor": "#009eff",
    "bgColor": "#ffffff",
    "qrStyle": "dots",
    "eyeStyle": "rounded",
    "logoImage": "https://example.com/logo.png",
    "logoWidth": 60,
    "logoHeight": 60,
    "logoPadding": 10,
    "logoStyle": "circle",
    "quietZone": 50
  }
}

Setelah disimpan, gaya ini secara otomatis diterapkan setiap kali Anda meminta gambar .qr.png — tidak perlu parameter kueri.

Cara gaya diterapkan

Gaya kode QR diselesaikan dalam urutan berikut:

1. 1
   Gaya default — Latar depan hitam pada latar belakang transparan, modul persegi, 1024px
2. 2
   Gaya yang tersimpan — Setiap kustomisasi yang Anda buat di editor kode QR atau atur melalui Link API disimpan dengan tautan
3. 3
   Pengesampingan parameter kueri — Mengesampingkan gaya individual per permintaan melalui parameter URL

Saat logo ada, Linkly secara otomatis menggunakan koreksi kesalahan tinggi (Level H) untuk memastikan kode QR tetap dapat dipindai.

Batas laju

Titik akhir dibatasi laju hingga 5 permintaan per detik per alamat IP. Gambar disimpan dalam cache selama 5 menit, jadi permintaan berulang untuk kode QR yang sama dilayani dengan cepat.

Respons

Permintaan yang berhasil mengembalikan status 200 dengan Content-Type: image/png dan data gambar PNG sebagai badan respons.

Respons kesalahan mengembalikan JSON:

{"error": "Rate limit exceeded"}

Sumber daya terkait

• Buat Kode QR - Cara membuat dan menyesuaikan kode QR di Linkly
• Tambahkan Logo ke Kode QR - Buat kode QR bermerek dengan logo perusahaan Anda
• Kode QR SVG - Unduh kode QR dalam format vektor yang dapat diskalakan
• Link Shortening API - Buat dan kelola tautan secara terprogram
• Analytics API - Ekspor data klik dan laporan lalu lintas