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

links array required
Array yang berisi beberapa tautan. Setiap item memiliki struktur yang sama dengan Create API.
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": [
        {
            "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

code integer
Kode respons: 0 = Berhasil, nilai lainnya = Error
message string
Pesan respons. Jika kode bukan 0, pesan error akan dikembalikan.
result array
Data respons. Jumlah URL pendek yang diminta dikembalikan dalam bentuk array.