API Pembuatan Link

Buat link pendek secara instan.

Masukkan URL tujuan dan dapatkan link pendek yang rapi dan siap dilacak. Atur redirect, preview, dan analitik dalam satu proses.

Perlu membuat banyak link sekaligus? Gunakan Bulk Create API atau kelola langsung di dashboard (login diperlukan).

Setiap link dilengkapi QR code otomatis.

  • Akses melalui https://vvd.bz/[linkId]/qr dan ubah ukuran dengan parameter size.
  • Contoh: https://vvd.bz/hj7V/qr?size=200 → menghasilkan QR code 200px.
POST

/api/link/v2/create 

{
    "url": "https://www.facebook.com/vivoldi365",
    "domain": "https://vvd.bz"
}

Request Parameters

url string required
URL asli.
Maksimal 3.000 byte diperbolehkan.
domain string required
Default:https://vvd.bz
Domain tautan.
Jika opsi “brandLinkId” disetel ke Y, domain akan menjadi https://vvd.im.
Anda juga bisa menggunakan domain kustom.
redirectType integer
Default:302
Enum:
200301302
Jenis redirect.
Lihat halaman Terminologi untuk detailnya.
Fitur ini tersedia pada paket Personal ke atas.
reuseYn string
Default:N
Enum:
YN
Menentukan apakah akan menggunakan kembali URL yang sudah ada.
Y: Jika URL panjang yang sama sudah ada, URL pendek baru tidak akan dibuat — sistem mengembalikan URL pendek pertama yang dibuat.
N: Selalu membuat URL pendek baru.

Opsi ini digunakan untuk mencegah duplikasi URL panjang atau menggunakan kembali tautan yang sudah ada.
Fitur ini hanya tersedia untuk paket Premium ke atas.
grpIdx integer
Digunakan untuk mengelompokkan tautan.
IDX grup bisa didapat melalui API Daftar Grup atau di dashboard.
brandLinkId string
Jika tidak diatur, ID tautan akan dibuat otomatis oleh sistem.
Tanpa domain kustom, domain default adalah https://vvd.im.
Contoh: https://vvd.im/[brandLinkId]
ttl string
Judul tautan. Jika tidak ditentukan, judul halaman web dari URL asli akan digunakan.
Untuk pembuatan cepat, isi nilai ini langsung agar proses parsing tidak diperlukan.
description string
Jika redirectType adalah 200, meta tag description dapat ditetapkan.
metaImg string
Jika redirectType adalah 200, meta tag image dapat ditetapkan.
URL gambar harus diawali dengan https://.
memo string
Catatan untuk manajemen tautan.
notfSubscYn string
Default:N
Enum:
YN
Apakah ini tautan berlangganan push.
Jika Y, halaman landing akan muncul sebelum diarahkan ke URL asli untuk meminta izin push.
Jika pengguna menolak atau membatalkan, akan langsung diarahkan ke URL asli.
qrBypassYn string
Default:N
Enum:
YN
Mengatur apakah akan melewati tautan pendek saat memindai kode QR dan langsung menuju ke URL asli yang ditentukan oleh pengguna.
Y: Langsung dialihkan ke URL asli tanpa melalui tautan pendek. (Statistik pemindaian QR tidak dicatat)
N: Melewati tautan pendek sebelum dialihkan ke URL asli. (Statistik pemindaian QR dicatat)
pushNotifyYn string
Default:N
Enum:
YN
Notifikasi push untuk klik.
Jika Y, pemberitahuan dikirim ke perangkat dengan aplikasi Vivoldi ketika jumlah klik yang ditentukan tercapai (diatur di Dashboard → Pengaturan).
Fitur ini tersedia pada paket Personal ke atas.
mailNotifyYn string
Default:N
Enum:
YN
Notifikasi email untuk klik.
Jika Y, email akan dikirim setiap kali jumlah klik yang ditentukan tercapai (diatur di Dashboard → Pengaturan).
Fitur ini tersedia pada paket Personal ke atas.
webhookEnableYn string
Default:N
Enum:
YN
Status penggunaan Webhook.
Webhook global harus diaktifkan.
Fitur ini hanya tersedia pada paket Enterprise.
webhookMetric string
Default:C
Enum:
CP
Kriteria penerimaan Webhook.
C: Berdasarkan jumlah klik, P: Berdasarkan jumlah pengguna unik (klik unik).
webhookFrequency integer
Default:1
Enum:
1501002003005001000
Frekuensi penerimaan Webhook.
1: Setiap klik, 50: Setiap 50 klik, 100: Setiap 100 klik, 300: Setiap 300 klik, 500: Setiap 500 klik, 1000: Setiap 1.000 klik.
delYmdt datetime
Tanggal penghapusan tautan terjadwal.
Setelah tanggal terlewati, tautan akan dihapus otomatis.
Contoh: 2025-08-30 23:59:59 
{
    "code": 0,
    "message": "",
    "result": "https://vvd.bz/jH3d"
}

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 ini dalam situasi berikut:

  • Mengubah URL panjang menjadi link pendek yang mudah dibagikan
  • Membuat link pelacakan untuk kampanye marketing
  • Menghasilkan banyak link secara otomatis
  • Membuat link dinamis melalui integrasi dengan layanan eksternal
Link pendek dilengkapi analitik bawaan untuk membantu pengambilan keputusan berbasis data.

Fitur utama

Lebih dari sekadar pemendek URL, hadir dengan kontrol yang lebih fleksibel.

  • redirectType: Tentukan jenis redirect (301, 302, 307, dll.)
  • reuseYn: Gunakan kembali link yang sama untuk URL identik
  • ttl, description, metaImg: Atur tampilan preview di media sosial (Open Graph)
  • pushNotifyYn, mailNotifyYn: Dapatkan notifikasi setiap ada klik
  • webhook: Kirim event ke sistem eksternal secara real-time
Link pendek dilengkapi analitik untuk membantu pengambilan keputusan berbasis data.

Contoh penggunaan

API pembuatan link dapat digunakan dalam berbagai skenario.

  • E-commerce: Buat link pendek otomatis untuk setiap produk
  • Iklan: Buat link pelacakan berdasarkan channel
  • SaaS: Buat link personal untuk setiap pengguna
  • CRM: Otomatiskan pembuatan link berdasarkan perilaku pelanggan

Catatan penting

Periksa hal berikut sebelum mengirim permintaan.

  • URL tidak valid akan menyebabkan proses gagal
  • Jika reuseYn aktif, link yang sudah ada bisa dikembalikan вместо membuat yang baru
  • redirectType memengaruhi SEO dan perilaku cache
  • Beberapa fitur tergantung pada paket yang digunakan
Pengaturan yang tepat memastikan hasil yang konsisten dan sesuai harapan.