API de validation des liens
Les liens courts Vivoldi intègrent des contrôles d’accès comme l’expiration, le mot de passe et la limite de clics.
Ces règles s’appliquent uniquement via le lien court. L’accès direct à l’URL d’origine les contourne.
Intégrez le SDK de validation sur la page cible pour appliquer les mêmes règles à tous les accès.
Disponible uniquement avec les offres premium.
Insérez le script Vivoldi dans la section <head>...</head> comme dans l’exemple ci-dessous.
<html>
<head>
<title>example page</title>
<script src="https://opencdn.vivoldi.com/js/v2/link.validate.min.js?v=202507301"></script>
<script>
const req = {
linkId:'xY5h', // Block access if not accessed via this link ID.
domain:'https://vvd.bz',
apiKey:'5oNyoLDuQ513cJ1rlYpJgHc9zu0H10F6'
};
vvdLinkValidate(req);
</script>
</head>
<body>
.
.
.
</body>
</html>
Pourquoi la validation des liens est importante
Les liens courts permettent d’appliquer des contrôles d’accès.
- Limites d’expiration
- Protection par mot de passe
- Limite de clics
Si un utilisateur accède au lien puis partage l’URL d’origine, ces restrictions peuvent être contournées.
Par exemple, même avec une limite de 100 clics, la diffusion de l’URL d’origine rend cette limite inefficace. En intégrant le SDK de validation, les mêmes règles s’appliquent aussi aux accès directs.
Fonctionnement
Le SDK valide chaque requête à partir des données du lien court.
Une seule ligne de code suffit pour sécuriser vos pages d’événements et de promotion.
Lors de l’intégration, configurez trois valeurs : linkId (ID du lien), domain (domaine) et apiKey (clé API).
Cas d’utilisation
Appliquez des règles d’accès sur tous les points d’entrée.
- Événements et promotions : Bloquer l’accès automatiquement après expiration
- Contenu réservé : Empêcher l’accès direct sans authentification
- Campagnes limitées : Arrêter la participation après dépassement du quota de clics
- Pages de membres : Restreindre l’accès après expiration du lien
- Autres : Protéger le contenu payant et éviter le partage non autorisé
Notes d’implémentation
Vérifiez ces points avant de déployer le SDK.
- Installez le SDK Vivoldi sur la page de destination
- Protégez votre clé API et évitez toute exposition publique
linkId, domain, apiKeydoivent être correctement configurés sinon la validation échoueraDisponible uniquement avec les offres premium