API zur Linkvalidierung
Vivoldi-Kurzlinks bieten Zugriffskontrollen wie Ablaufdatum, Passwortschutz und Klicklimits.
Diese Regeln gelten nur beim Zugriff über den Kurzlink. Direkter Zugriff auf die Original-URL umgeht sie.
Integrieren Sie das JavaScript-SDK auf der Zielseite, um dieselben Regeln für alle Zugriffe durchzusetzen.
Verfügbar in Premium-Tarifen und höher.
Fügen Sie das Vivoldi-Skript wie im Beispiel im <head>...</head>-Bereich ein.
<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>
Warum Link-Validierung wichtig ist
Kurzlinks ermöglichen Zugriffsbeschränkungen.
- Ablaufzeiten
- Passwortschutz
- Klicklimits
Wird die Original-URL nach dem Zugriff geteilt, können diese Einschränkungen umgangen werden.
Beispielsweise verliert ein Klicklimit von 100 seine Wirkung, sobald die Original-URL verbreitet wird. Durch die Integration des SDKs auf der Zielseite werden dieselben Regeln auch bei direktem Zugriff durchgesetzt.
Funktionsweise
Das SDK prüft jede Anfrage anhand der Daten aus dem Kurzlink.
Mit nur einer Codezeile schützen Sie Event- und Promotionsseiten.
Bei der Integration müssen drei Werte gesetzt werden: linkId (Link-ID), domain (Domain) und apiKey (API-Schlüssel).
Anwendungsfälle
Zugriffskontrollen über alle Zugangswege hinweg durchsetzen.
- Events & Aktionen: Zugriff nach Ablauf automatisch sperren
- Exklusive Inhalte: Direkten Zugriff ohne Authentifizierung verhindern
- Limitierte Kampagnen: Teilnahme nach Erreichen des Klicklimits stoppen
- Mitgliederseiten: Zugriff nach Ablauf einschränken
- Weitere: Bezahlte Inhalte schützen und unbefugte Weitergabe verhindern
Hinweise zur Implementierung
Bitte prüfen Sie diese Punkte vor der Implementierung.
- Das Vivoldi-SDK muss auf der Zielseite installiert sein
- Der API-Schlüssel sollte sicher aufbewahrt und nicht öffentlich zugänglich sein
linkId, domain, apiKeymüssen korrekt gesetzt sein, sonst schlägt die Validierung fehlVerfügbar in Premium-Tarifen und höher