Buat Tautan

Ini adalah API dasar untuk membuat tautan pendek.

Untuk membuat beberapa tautan sekaligus, gunakan Bulk Create API atau menu [Buat Tautan Massal] di dashboard.

Setiap tautan pendek secara otomatis memiliki kode QR.

  • Kode QR tersedia di https://vvd.bz/[linkId]/qr, dan ukurannya dapat diatur dengan parameter size.
  • Contoh: https://vvd.bz/hj7V/qr?size=200 → Mengembalikan kode QR berukuran 200px.
POST

/api/link/v2/create 

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

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.
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.
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.
delYmdtdatetime
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

codeinteger
Kode respons: 0 = Berhasil, nilai lainnya = Error
messagestring
Pesan respons. Jika kode bukan 0, pesan error akan dikembalikan.
resultstring
Nilai respons. Tautan pendek dikembalikan.
Contoh: https://vvd.bz/jH3d