API Pembaruan Link

Perbarui link yang sudah ada tanpa mengubah ID-nya.

Ubah URL tujuan, jenis redirect, preview, dan notifikasi dengan tetap menggunakan linkId yang sama.

Hanya untuk link tipe URL. Link form, tombol, dan jenis lainnya tidak didukung oleh API ini.

PUT

/api/link/v2/update 

{
    "linkId": "4Rt3",
    "domain": "https://vvd.bz",
    "ttl": "new title",
    "memo": "new my memo"
}

Request Parameters

linkId string required
ID tautan.
Jika URL adalah “https://vvd.bz/fML”, maka ID tautannya adalah fML.
domain string required
Default:https://vvd.bz
Domain tautan.
redirectType integer
Default:302
Enum:
200301302
Jenis redirect.
Lihat halaman Terminologi untuk detailnya.
Fitur ini tersedia pada paket Personal ke atas.
grpIdx integer
Digunakan untuk mengelompokkan tautan.
IDX grup bisa didapat melalui API Daftar Grup atau dari dashboard.
url string
URL asli. Maksimal 3.000 byte diperbolehkan.
Fitur ini tersedia pada paket Premium ke atas.
ttl string
Judul tautan.
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 akan dikirim ke perangkat dengan aplikasi Vivoldi ketika jumlah klik yang ditentukan tercapai (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 (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": null
}

Response Parameters

code integer
Kode respons: 0 = Berhasil, nilai lainnya = Error
message string
Pesan respons. Jika kode bukan 0, pesan error akan dikembalikan.
result null

Kapan menggunakan API ini

Gunakan API ini dalam situasi berikut:

  • Memperbarui URL tujuan dari link pendek yang sudah ada
  • Mengubah jenis redirect, masa berlaku, catatan, atau pengaturan lainnya
  • Mengedit link aktif tanpa menghapus atau menggantinya
  • Menyesuaikan webhook, notifikasi, atau integrasi setelah digunakan
Link tetap sama, sehingga perubahan dapat dilakukan tanpa mengganggu link yang sudah dibagikan.

Perbedaan dengan API pembuatan

Struktur mirip, tujuan berbeda.

  • linkId dan domain wajib untuk menentukan link secara tepat
  • Hanya ubah parameter yang diperlukan
  • Statistik dan data tetap dipertahankan
  • Perubahan url tersedia untuk paket premium ke atas
  • Link non-URL seperti form atau tombol tidak didukung
Gunakan API ini untuk memperbarui pengaturan tanpa membuat link baru.

Contoh penggunaan

Kontrol penuh untuk link yang sudah beredar.

  • E-commerce: Perbarui URL tujuan secara dinamis sesuai stok atau ketersediaan
  • Iklan: Gunakan link yang sama sambil mengganti landing page sesuai musim
  • Operasional: Alihkan ke halaman cadangan secara instan saat terjadi gangguan
  • Perbarui judul dan gambar preview untuk media sosial
Cocok untuk memperbarui konten tanpa mengganggu link yang sudah dibagikan.

Hal yang perlu diperhatikan

Perhatikan hal berikut sebelum memperbarui link.

  • Perubahan URL tujuan dapat memengaruhi pengalaman pengguna
  • Kesalahan pengaturan dapat memengaruhi perilaku link
  • Jika notfSubscYn disetel ke Y, notifikasi akan dikirim ke pelanggan sebelum perubahan. Notifikasi yang sudah dikirim tidak dapat dibatalkan.
  • Link yang telah dihapus tidak dapat dipulihkan melalui API ini
Periksa konfigurasi saat ini sebelum melakukan perubahan.