API Pengembang

Pembuatan Tautan Massal

API ini memungkinkan Anda membuat beberapa tautan pendek sekaligus.
Untuk pembuatan tautan dalam jumlah besar, gunakan menu “Pembuatan Tautan Massal” di dasbor.

Jumlah tautan yang dapat dibuat per permintaan dibatasi menurut paket langganan.
Untuk membuat lebih banyak, Anda harus membagi proses menjadi beberapa pemanggilan API.

Paket Personal: Maksimal 100 tautan
Paket Premium: Maksimal 200 tautan
Paket Bisnis: Maksimal 300 tautan

API ini tersedia mulai dari paket Personal ke atas.

Http Header

POST /api/link/v1/createBulk
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: application/json
User-agent: {Your User-agent}
Accept-Language: en

Request

{
	"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"
		}
	]
}

Bidang

Jenis

links

Bidang	Deskripsi Lapangan	Deskripsi	Jenis
url	URL Panjang	URL panjang yang akan menjadi tujuan saat tautan pendek yang dibuat diklik. Panjang maksimal 3.000 byte.	string
domain	Domain	Jika dikosongkan, otomatis akan menggunakan domain vvd.bz. Harus menyertakan "https://", dan jika opsi “brandLinkId” adalah “Y”, gunakan domain “https://vvd.im”. Jika domain Anda telah terhubung ke Vivoldi, bisa diatur di sini. Contoh: https://vvd.bz	string
redirectType	Tipe Redirect	Mengatur bagaimana perpindahan dari URL pendek ke URL panjang. Bisa memilih salah satu kode status HTTP: 200, 301, atau 302. Nilai default: 302 Untuk info lebih lanjut, lihat halaman “Glosarium”.	int
grpIdx	ID Grup	Menentukan ID grup akan membuat tautan terhubung ke grup tersebut. Untuk melihat GroupID, gunakan API “Daftar Grup”.	int
brandLinkId	ID Tautan Merek	Jika diisi, tautan akan dibuat dengan ID tersebut. (Jika diatur, domain akan menjadi vvd.im, bukan vvd.bz) Jika dikosongkan, linkID akan dibuat otomatis.	string
ttl	Judul Tautan	Jika kosong, akan menggunakan judul halaman web dari URL panjang. Jika kosong, sistem akan mengakses URL panjang dan melakukan parsing HTML, sehingga jika API terasa lambat, sebaiknya tentukan judulnya.	string
description	Deskripsi Meta	Bisa diatur sebagai tag meta description halaman jika “redirectType” bernilai “200”. Nilai ini diabaikan jika “redirectType” adalah “301”, “302”, dsb.	string
metaImg	Meta gambar	Anda hanya dapat mengatur tag meta gambar saat nilai redirectType adalah “200”. Nilai meta gambar harus dalam format URL yang dimulai dengan “https://”. Jika redirectType adalah “301” atau “302”, nilai tersebut diabaikan.	string
memo	Catatan	Bisa diisi informasi tambahan untuk kebutuhan administrasi dan tidak akan terlihat oleh pengguna.	string
notfSubscYn	Tautan Push	Jika bernilai Y, saat tautan diakses, pop-up notifikasi push akan muncul sebelum diarahkan ke URL panjang. Notifikasi dapat dikirim ke semua pengguna yang mengizinkan. Jika pengguna menolak atau menutup pop-up, langsung diarahkan ke URL panjang. Jika kosong, default adalah N. Info lebih lanjut di halaman fitur Web Push.	Y atau N
pushNotifyYn	Notifikasi Push	Jika bernilai Y, Anda akan menerima notifikasi push di perangkat dengan aplikasi Vivoldi ketika jumlah klik tercapai (set sesuai pengaturan tautan di menu “Pengaturan -> Preferensi”). Tersedia mulai Paket Personal.	Y atau N
mailNotifyYn	Notifikasi Email	Jika bernilai Y, info jumlah klik akan dikirim ke email terdaftar Vivoldi setiap kali target klik tercapai (pengaturan di menu “Pengaturan -> Preferensi”). Tersedia mulai Paket Personal.	Y atau N
delYmd	Tanggal Penghapusan Tautan	Setelah tanggal yang ditentukan, tautan akan otomatis dihapus oleh sistem. Siklus penghapusan: setiap jam Contoh: 2025-12-31	Date

array

Response

{
	"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"
		}
	]
}

Bidang	Deskripsi	Jenis
code	Kode respons. `0` menunjukkan sukses; nilai lain menunjukkan kegagalan.	int
message	Pesan respons. Hanya muncul jika `code` bukan 0, berisi pesan kesalahan.	string
result	Data respons. Mengembalikan daftar URL pendek yang dibuat sesuai jumlah permintaan.	array