API Validasi Link
Link pendek Vivoldi dilengkapi kontrol akses seperti masa berlaku, kata sandi, dan batas klik.
Pembatasan ini hanya berlaku saat diakses melalui link pendek. Akses langsung ke URL asli tidak terpengaruh.
Tambahkan SDK validasi ke halaman tujuan untuk menerapkan aturan yang sama di semua jalur akses.
SDK ini hanya tersedia untuk paket premium ke atas.
Masukkan script Vivoldi ke dalam bagian <head>...</head> seperti contoh di bawah ini.
<html>
<head>
<title>example page</title>
<script src="https://opencdn.vivoldi.com/js/v3/link.validate.min.js?v=202610271"></script>
<script>
// Do not add your API Key to web pages. It is not required for link validation.
const req = {
linkId:'xY5h', // Block access if not accessed via this link ID.
domain:'https://vvd.bz'
};
vvdLinkValidate(req);
</script>
</head>
<body>
.
.
.
</body>
</html>
Mengapa validasi tautan penting
Link pendek dapat menerapkan berbagai kontrol akses.
- Batas masa berlaku
- Perlindungan kata sandi
- Batas jumlah klik
Setelah pengguna mengakses halaman dan membagikan URL asli, pembatasan ini bisa dilewati.
Misalnya, meskipun batas klik ditetapkan 100, saat URL asli tersebar, pembatasan tidak lagi berlaku. Dengan menambahkan SDK validasi ke halaman tujuan, aturan yang sama tetap diterapkan pada akses langsung.
Cara kerja
SDK memvalidasi setiap permintaan menggunakan data dari link pendek.
Cukup tambahkan satu baris kode untuk melindungi halaman event dan promosi.
Saat integrasi, atur dua nilai: linkId (ID link) dan domain (domain). API key tidak diperlukan.
Contoh penggunaan
Terapkan kontrol akses di semua jalur akses.
- Event & promosi: Blokir akses otomatis setelah masa berlaku habis
- Konten khusus: Cegah akses langsung ke URL asli tanpa autentikasi
- Kampanye terbatas: Hentikan partisipasi setelah batas klik tercapai
- Halaman membership: Batasi akses setelah link kedaluwarsa
- Lainnya: Lindungi konten berbayar dan cegah penyebaran link tanpa izin
Catatan implementasi
Periksa hal berikut sebelum menerapkan SDK.
- Pasang SDK Vivoldi di halaman tujuan
- Jangan cantumkan API key di halaman web. Validasi link tidak memerlukannya
- Jika menggunakan SDK v2, ubah URL skrip ke v3 dan hapus
apiKey. Sebaiknya terbitkan ulang API key yang telah terekspos linkId, domainharus diatur dengan benar atau validasi akan gagalSDK ini hanya tersedia untuk paket premium ke atas