Pembuatan Tautan Massal

API untuk membuat beberapa tautan pendek sekaligus.
Jika perlu pembuatan massal, Anda juga bisa menggunakan menu [Buat Tautan Massal] di dashboard.

Jumlah maksimum tautan yang dapat dibuat sekaligus sesuai paket adalah:

  • Paket Personal: hingga 100
  • Paket Premium: hingga 200
  • Paket Bisnis: hingga 300

Jika membutuhkan lebih banyak tautan, panggil API ini beberapa kali.
API ini tersedia mulai dari paket Personal ke atas.

POST

/api/link/v1/createBulk 

{
    "links": [
        {
            "url": "https://google.com",
            "domain": "https://vvd.bz"
        },
        {
            "url": "https://facebook.com",
            "domain": "https://vvd.bz"
        },
        {
            "url": "https://twitter.com",
            "domain": "https://vvd.bz"
        }
    ]
}

Request Parameters

linksarrayrequired
Array yang berisi beberapa tautan. Setiap item memiliki struktur yang sama dengan Create API.
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.
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 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "shortUrl": "https://vvd.bz/bbuR",
            "url": "https://google.com"
        },
        {
            "shortUrl": "https://vvd.bz/bbuS",
            "url": "https://facebook.com"
        },
        {
            "shortUrl": "https://vvd.bz/bbuT",
            "url": "https://twitter.com"
        }
    ]
}

Response Parameters

codeinteger
Kode respons: 0 = Berhasil, nilai lainnya = Error
messagestring
Pesan respons. Jika kode bukan 0, pesan error akan dikembalikan.
resultarray
Data respons. Jumlah URL pendek yang diminta dikembalikan dalam bentuk array.