Buat Tautan

Request Parameters

urlstringrequired

URL asli.
Maksimal 3.000 byte diperbolehkan.

domainstringrequired

Default:https://vvd.bz

Domain tautan.
Jika opsi “brandLinkId” disetel ke Y, domain akan menjadi https://vvd.im.
Anda juga bisa menggunakan domain kustom.

redirectTypeinteger

Default:302

Enum:

200301302

Jenis redirect.
Lihat halaman Terminologi untuk detailnya.
Fitur ini tersedia pada paket Personal ke atas.

reuseYnstring

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.

grpIdxinteger

Digunakan untuk mengelompokkan tautan.
IDX grup bisa didapat melalui API Daftar Grup atau di dashboard.

brandLinkIdstring

Jika tidak diatur, ID tautan akan dibuat otomatis oleh sistem.
Tanpa domain kustom, domain default adalah https://vvd.im.
Contoh: https://vvd.im/[brandLinkId]

ttlstring

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.

descriptionstring

Jika redirectType adalah 200, meta tag description dapat ditetapkan.

metaImgstring

Jika redirectType adalah 200, meta tag image dapat ditetapkan.
URL gambar harus diawali dengan https://.

memostring

Catatan untuk manajemen tautan.

notfSubscYnstring

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.

qrBypassYnstring

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)

pushNotifyYnstring

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.

mailNotifyYnstring

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.

webhookEnableYnstring

Default:N

Enum:

YN

Status penggunaan Webhook.
Webhook global harus diaktifkan.
Fitur ini hanya tersedia pada paket Enterprise.

webhookMetricstring

Default:C

Enum:

CP

Kriteria penerimaan Webhook.
C: Berdasarkan jumlah klik, P: Berdasarkan jumlah pengguna unik (klik unik).

webhookFrequencyinteger

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.

delYmdtdatetime

Tanggal penghapusan tautan terjadwal.
Setelah tanggal terlewati, tautan akan dihapus otomatis.
Contoh: 2025-08-30 23:59:59