홈
서비스 소개
개발자 API
가격 · 요금제
온라인 쿠폰
웹푸시 소개

링크 생성

짧은 URL을 생성하는 API입니다.
여러 개의 링크를 한 번에 생성하려면 “일괄 생성(Bulk Create)” API를 사용해보세요.
또는 대시보드의 “대량 링크 만들기” 메뉴에서도 빠르게 생성할 수 있습니다.

모든 단축 링크에는 QR 코드가 자동으로 함께 생성되며,
생성된 QR 코드는 다음과 같은 형식의 URL로 확인할 수 있습니다:
vvd.bz/[linkId]/qr

QR 코드의 크기를 조절하려면 size 파라미터를 추가하세요.
예: vvd.bz/[linkId]/qr?size=200 → 200픽셀 크기의 QR 코드 반환

Http Header 
POST /api/link/v2/create
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: application/json
User-agent: {Your User-agent}
Accept-Language: en
Request 
{
	"url": "https://www.facebook.com/vivoldi365",
	"domain": "https://vvd.bz"
}
필드필드 설명설명필수유형
url긴 URL 생성된 짧은 링크를 클릭했을 때 이동될 긴 URL.
최대 3,000 bytes까지 설정할 수 있습니다. 		string
domain도메인 값이 비어 있으면 자동으로 vvd.bz 도메인으로 설정됩니다.
“https://” 값을 포함하여 설정해야 하며, “brandLinkId” 옵션이 “Y”일 경우 도메인은 “https://vvd.im”으로 설정하세요.
귀하가 소유한 도메인을 비볼디와 연동하였을 경우 해당 도메인을 설정하면 됩니다.
예: https://vvd.bz 		string
redirectTypeRedirect 방법 짧은 URL에서 긴 URL로 이동되는 방식을 설정합니다.
HTTP의 상태 응답 코드로 200, 301, 302 중에 하나를 선택할 수 있습니다. 기본 값: 302
Redirect 방법에 대한 자세한 내용는 “용어 정리” 페이지에서 확인하세요. 		int
grpIdx그룹ID 그룹ID를 설정하면 해당 그룹에 링크가 생성됩니다.
그룹ID를 확인하려면 "그룹 목록" API를 호출하여 확인해야 합니다. 		int
brandLinkId브랜드 링크ID 값을 지정하면 해당 ID로 링크가 생성됩니다.
(브랜드 링크가 설정된 경우 도메은 vvd.bz이 아닌 vvd.im 입니다)
값이 비어 있으면 링크ID는 자동으로 생성됩니다. 		string
ttl링크 제목 값이 비어 있으면 긴 URL의 웹페이지 제목으로 저장됩니다.
값이 비어있을 때, 긴 URL에 접속하여 HTML 파싱 작업이 이루어 지므로 API 호출 후 응답 속도가 느리다면 제목을 설정하세요.		string
descriptionMeta 내용 “redirectType”의 값이 “200”일 때 페이지의 메타 태그인 description을 설정할 수 있습니다.
“redirectType”의 값이 “301”, “302”일 때는 이 값은 무시됩니다. 		string
metaImgMeta 이미지 redirectType의 값이 “200”일 때에만 메타 이미지 태그를 설정할 수 있습니다.
메타 이미지 값은 반드시 “https://”로 시작하는 URL 형식이어야 합니다.
redirectType이 “301” 또는 “302”인 경우에는 해당 값이 무시됩니다. 		string
memo메모 사용자에게 노출되지 않고 관리에 필요한 부가 정보를 설정할 수 있습니다. string
notfSubscYn푸시구독 링크 값이 Y일 경우 생성된 링크를 클릭하면 긴 링크로 이동되기 전 웹푸시 알림 팝업이 표시되고
사용자가 푸시알림에 허용할 경우 허용한 모든 사용자들에게 푸시 메시지를 전송할 수 있습니다.
알림 팝업에 동의하지 않거나 취소할 경우 즉시 원래의 긴 URL로 이동됩니다.
값을 입력하지 않으면 기본 값은 N 입니다.
푸시구독 링크에 대해 자세히 알아보시려면 웹푸시 기능 소개 페이지에서 살펴보세요. 		Y or N
blockOverseasSticsYn해외통계 차단 값이 Y일 경우 한국 이외 국가에서 링크를 클릭할 경우 링크 접속은 가능하지만 클릭 수 통계를 저장하지 않습니다.
악성 봇 또는 검색 로봇으로 인해 클릭 수가 비정상적으로 많을 경우 값을 Y로 설정하세요. 		Y or N
pushNotifyYn클릭 수 푸시 알림 값이 Y일 경우 "설정 -> 환경 설정" 페이지의 링크 설정에서 설정된 링크 클릭 수에 도달할 때 마다 비볼디 앱이 설치된 모바일 기기로 클릭 수 푸시 알림을 수신할 수 있습니다.
이 기능은 퍼스널 요금제부터 이용할 수 있습니다. 		Y or N
mailNotifyYn클릭 수 메일 알림 값이 Y일 경우 "설정 -> 환경 설정" 페이지의 링크 설정에서 설정된 링크 클릭 수에 도달할 때 마다 비볼디에 가입된 이메일로 클릭 수 정보를 수신할 수 있습니다.
이 기능은 퍼스널 요금제부터 이용할 수 있습니다. 		Y or N
delYmd링크 삭제 날짜 설정된 날짜가 지나면 링크가 시스템에 의해 자동으로 삭제됩니다.
삭제 주기: 1시간 마다
예: 2025-12-31 		Date
 
Response 
{
	"code": 0,
	"message": "",
	"result": "https://vvd.bz/jH3d"
}
필드설명유형
code응답 코드 (0:성공)int
message응답 메시지, 응답 코드가 0이 아닐 경우 관련 메시지가 리턴됨.string
result응답 값 (단축된 링크)string