링크 검증 API

비볼디 단축 링크는 유효기간, 비밀번호, 최대 클릭 수 제한 등 다양한 접근 제어 기능을 지원합니다.

단, 이 제한은 단축 링크를 통해 접속할 때만 적용되며, 원본 URL을 직접 공유받은 사용자는 제한 없이 접근할 수 있습니다.

링크 검증 JavaScript SDK를 원본 URL 페이지에 적용하면 단축 링크와 원본 페이지가 연동되어 모든 접근 경로에서 동일한 제한이 적용됩니다.
이 SDK는 프리미엄 요금제 이상에서만 제공됩니다.

아래 샘플 코드와 같이 비볼디 스크립트를 <head>...</head> 구간에 삽입하세요.

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>

왜 링크 검증이 필요한가요?

단축 URL에는 다양한 접근 제한을 설정할 수 있습니다.

  • 유효기간 제한
  • 비밀번호 보호
  • 최대 클릭 수 제한

사용자가 단축 링크를 통해 원본 URL에 한 번 접속한 후, 해당 URL을 직접 공유하면 이러한 제한이 적용되지 않을 수 있습니다.

예를 들어, 이벤트 페이지 URL에 최대 클릭 수 100회를 설정했더라도, 원본 URL이 외부에 노출된 순간 클릭 수 제한은 의미가 없어집니다. 링크 검증 SDK를 원본 URL 페이지에 삽입하면 단축 링크의 제한 조건이 원본 페이지 접속 시에도 동일하게 검증되어 이 문제를 해결할 수 있습니다.

동작 방식

SDK는 단축 링크를 통해 전달된 정보를 기반으로 요청을 검증합니다.
단 한 줄의 코드만 추가하면 이벤트·프로모션 페이지까지 안전하게 보호할 수 있습니다.

SDK 적용 시 linkId(보호할 단축 링크 ID), domain(링크 도메인), apiKey(발급받은 API 키) 3가지 값을 설정해야 합니다.

조건을 만족하지 않으면 단축 링크로 리다이렉션하거나 접근을 차단합니다.

활용 예시

링크 검증 API는 다음과 같은 상황에서 유용합니다.

  • 이벤트·프로모션: 유효기간이 지난 후 원본 페이지 접근 자동 차단
  • 회원 전용 콘텐츠: 비밀번호 없이 원본 URL로 직접 접근하는 경우 차단
  • 선착순 이벤트: 최대 클릭 수 초과 시 원본 페이지에서도 참여 불가 처리
  • 멤버십 혜택 페이지: 링크 만료 후 혜택 페이지 자동 접근 제한
  • 기타: 유료 콘텐츠 접근 제한 및 캠페인 링크 무단 공유 방지
특히 마케팅 및 콘텐츠 보호가 중요한 서비스에서 효과적으로 활용할 수 있습니다.

적용 시 주의사항

SDK 적용 시 다음 사항을 확인하세요.

  • 원본 페이지에 비볼디의 SDK가 반드시 적용되어야 합니다
  • API 키는 외부에 노출되지 않도록 관리해야 합니다
  • linkId, domain, apiKey 3가지 값이 정확히 설정되지 않으면 검증에 실패합니다
  • 이 SDK는 프리미엄 요금제 이상에서만 제공됩니다
정확한 설정을 통해 원하는 동작을 보장할 수 있습니다.