Developer API

Link Validation

Vivoldi supports various access restriction settings for short links, such as expiration time, password, and maximum allowed clicks.
These restrictions are only enforced when users access the page through a Vivoldi short link.
If a user directly accesses the original long URL in the browser, the protection will not be validated and may be bypassed.

To solve this issue, Vivoldi provides a dedicated JavaScript SDK.
When applied to a webpage that uses the long URL, the SDK automatically checks the link’s protection settings (expiration, password, click limits, etc.)
and redirects the user to the Vivoldi short link or blocks access if the conditions are not met.

With just a single line of code, you can add powerful access control to your event or promotion page.

This JavaScript SDK is available from the Premium plan.

Insert the Vivoldi script into the <head>...</head> section as shown below:

example.html

<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>