Instal aplikasi Vivoldi dari Google Play untuk membuatnya lebih nyaman.

API QR Code

Buat QR code yang dapat dikustomisasi hanya dengan satu panggilan API.

Masukkan URL, teks, atau nomor telepon ke dalam QR,
dan sesuaikan warna, marker, style, serta logo sesuai brand Anda.

Setiap QR code disertai link—siap digunakan atau diunduh sebagai gambar.

  • Akses QR code di https://vvd.bz/[linkId]/qr dan atur ukuran dengan parameter size.
  • Contoh: https://vvd.bz/hj7V/qr?size=500 → menghasilkan QR 500px (maks. 4096px)
POST

/api/link/v1/create/qr 

{
    "type": "url",
    "url": "https://www.youtube.com/vivoldi365",
    "domain": "https://vvd.bz",
    "logoType": "U",
    "logo": "https://example.com/images/picture/logo/500x500.png"
}

Request Parameters

domain string required
Default:https://vvd.bz
Domain link. Secara default menggunakan https://vvd.bz. Jika brandLinkId disetel, domain akan menggunakan https://vvd.im.
Jika menggunakan domain kustom, Anda dapat menetapkannya di sini.
type string required
Default:url
Enum:
urltextphone
Tipe QR code.
  • url: URL website
  • text: Teks
  • phone: Nomor telepon
Field yang diperlukan berbeda tergantung tipe, jadi kirimkan parameter yang sesuai.
url string
URL tujuan saat QR dipindai. Wajib jika type adalah url. Harus berupa URL lengkap http atau https.
Maksimum 2,000 bytes.
text string
Teks yang dimasukkan ke dalam QR code. Digunakan saat type adalah text dan akan ditampilkan langsung saat dipindai.
Cocok untuk pesan, kode, atau instruksi. Tampilan bisa berbeda tergantung perangkat.
Maksimum 65,535 bytes.
phone string
Nomor telepon yang dihubungkan saat QR dipindai. Digunakan saat type adalah phone dan akan membuka layar panggilan.
Maksimum 32 karakter. Disarankan menyertakan kode negara.
logoType string
Default:N
Enum:
NCU
Tipe logo di tengah QR code.
  • N: Tanpa logo
  • C: Logo default organisasi
  • U: Logo upload pengguna

Logo meningkatkan brand awareness. Fitur ini tersedia mulai paket Personal.

logo string
URL gambar logo di tengah QR code. Digunakan saat logoType adalah U. Harus dapat diakses publik.
Disarankan berbentuk persegi dan PNG transparan.
Maksimum 500x500 px.
foreground string
Warna utama QR code (HEX). Default hitam.
Pastikan kontras cukup dengan background.
Default: #000000FF
background string
Warna background QR code (HEX). Default putih.
Background terlalu gelap dapat menurunkan akurasi scan.
Default: #FFFFFFFF
markerColor string
Warna marker posisi QR code.
Default: #000000FF
markerBorderColor string
Warna border marker.
Default: #000000FF
style string
Gaya visual QR code. Lihat preview di dashboard.
markerStyle string
Gaya marker QR code. Mendukung berbagai bentuk.
grpIdx integer
ID grup untuk manajemen QR code.
brandLinkId string
Jika tidak diatur akan dibuat otomatis. Domain default https://vvd.im
ttl string
Judul internal.
memo string
Catatan internal (tidak terlihat oleh pengguna).
qrBypassYn string
Y: langsung ke URL (tanpa tracking)
N: lewat short link (tracking aktif)
pushNotifyYn string
Notifikasi push saat scan.
mailNotifyYn string
Notifikasi email saat scan.
delYmdt datetime
Tanggal penghapusan otomatis. 
{
    "code": 0,
    "message": "",
    "result": "https://vvd.bz/K56t"
}

Response Parameters

code integer
Kode respons: 0 = Berhasil, nilai lainnya = Error
message string
Pesan respons. Jika kode bukan 0, pesan error akan dikembalikan.
result string
Nilai respons. Tautan pendek dikembalikan.
Contoh: https://vvd.bz/jH3d

Kapan menggunakan API ini

Gunakan API QR Code dalam situasi berikut:

  • Saat perlu membuat QR code dalam jumlah besar melalui integrasi dengan sistem eksternal
  • Saat ingin membuat QR code dengan warna dan logo brand melalui API
  • Saat perlu menghasilkan QR code secara dinamis untuk produk, kartu nama, atau media cetak
  • Saat membutuhkan QR code untuk URL, teks, atau nomor telepon
Dirancang untuk otomatisasi dan skala besar, bukan pembuatan manual di dashboard.

Jenis QR Code

Saat ini API mendukung jenis QR code berikut:

  • url: QR untuk URL halaman web. Maksimum 2.000 byte
  • text: QR untuk teks biasa. Maksimum 65.535 byte
  • phone: QR untuk nomor telepon. Maksimum 32 karakter

Dashboard mendukung tipe tambahan seperti email dan WiFi, namun API saat ini masih terbatas.
Tipe baru akan ditambahkan pada pembaruan berikutnya.

Contoh penggunaan

API QR Code dapat digunakan dalam berbagai skenario:

  • E-commerce: Buat QR per produk secara otomatis untuk kemasan dan label
  • Kartu nama & cetak: Buat QR dengan warna dan logo brand
  • Event offline: Generate QR unik dalam jumlah besar untuk tiket dan peserta
  • Restoran & toko: Perbarui QR menu dan meja secara otomatis saat konten berubah
Cocok untuk memberikan akses cepat dan praktis di lingkungan mobile.

Opsi desain dan gaya

Sesuaikan tampilan QR code sesuai kebutuhan Anda.

Atur warna melalui foreground (default #000000FF), background (default #FFFFFFFF), markerColor (default #000000FF), dan markerBorderColor (default #000000).

Pilih pola melalui style—rectangles, small-rectangles, dots, round, rows, columns, snakes, atau water—dan sesuaikan marker dengan markerStyle.

Tambahkan logo dengan mengatur logoType ke U (upload sendiri) atau C (logo organisasi). Fitur ini tersedia mulai paket Personal.
Masukkan URL gambar di logo. Ukuran yang disarankan: maksimal 500×500px.

Hal yang perlu diperhatikan

Perhatikan hal berikut saat membuat QR code:

  • Kontras warna yang rendah dapat menurunkan akurasi pemindaian
  • Desain yang terlalu kompleks dapat mempengaruhi performa scan
  • API saat ini hanya mendukung sebagian jenis QR code
Untuk hasil yang stabil, mulai dari pengaturan default lalu sesuaikan sesuai kebutuhan.