Buat Tautan

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