일괄 링크 생성

한 번에 여러 개의 단축 링크를 생성하는 API입니다.
대량 생성이 필요한 경우, 대시보드의 [대량 링크 만들기] 메뉴도 사용할 수 있습니다.

요금제별 한 번에 생성 가능한 최대 링크 개수는 다음과 같습니다.

  • 퍼스널 요금제: 최대 100개
  • 프리미엄 요금제: 최대 200개
  • 비즈니스 요금제: 최대 300개

더 많은 링크가 필요하다면 이 API를 여러 번 나누어 호출해야 합니다.
이 API는 퍼스널 요금제 이상에서만 제공됩니다.

POST

/api/link/v1/createBulk 

{
    "links": [
        {
            "url": "https://google.com",
            "domain": "https://vvd.bz"
        },
        {
            "url": "https://facebook.com",
            "domain": "https://vvd.bz"
        },
        {
            "url": "https://twitter.com",
            "domain": "https://vvd.bz"
        }
    ]
}

Request Parameters

linksarrayrequired
여러 링크를 담는 배열입니다. 각 항목의 구조는 Create API와 동일합니다.
urlstringrequired
원본 URL. 최대 3,000 bytes까지 입력 가능합니다.
domainstringrequired
Default:https://vvd.bz
링크 도메인. “brandLinkId” 옵션이 Y일 경우 도메인은 https://vvd.im 입니다.
커스텀 도메인을 입력할 수도 있습니다.
redirectTypeinteger
Default:302
Enum:
200301302
Redirect 방식. 자세한 내용는 주요 용어 페이지에서 확인하세요.
이 기능은 퍼스널 요금제 이상에서만 제공됩니다.
grpIdxinteger
링크를 그룹화할 때 사용됩니다. 그룹IDX는 그룹 목록 API를 호출하거나 대시보드에서 확인할 수 있습니다.
brandLinkIdstring
이 값이 설정되지 않으면 링크ID는 시스템에서 자동으로 생성됩니다.
커스텀 도메인을 사용하지 않는 경우, 기본 링크 도메인은 https://vvd.im 입니다.
예: https://vvd.im/[brandLinkId]
ttlstring
링크 제목입니다. 값이 지정되지 않으면 원본 URL의 웹페이지 제목이 자동으로 사용됩니다.
빠른 링크 생성을 원한다면 값을 직접 지정하여 불필요한 파싱 과정을 줄이세요.
descriptionstring
redirectType 값이 200일 경우, description 메타 태그를 설정할 수 있습니다.
metaImgstring
redirectType 값이 200일 경우, image 메타 태그를 설정할 수 있습니다.
이미지 URL은 반드시 https://로 시작해야 합니다.
memostring
링크 관리용 메모입니다.
notfSubscYnstring
Default:N
Enum:
YN
푸시구독 링크 여부입니다. 값이 Y이면 원본 URL로 이동되기 전에 랜딩 페이지가 열리며, 사용자에게 푸시 알림 권한을 요청합니다.
사용자가 권한을 거부하거나 취소하면 즉시 원본 URL로 이동됩니다.
blockOverseasSticsYnstring
Default:N
Enum:
YN
해외통계 차단 여부입니다. 한국 외 국가에서 접속하면 클릭 수는 집계되지 않습니다.
pushNotifyYnstring
Default:N
Enum:
YN
클릭 수 푸시 알림 여부입니다. 값이 Y이면 대시보드의 [설정 -> 환경 설정]에서 지정한 클릭 수에 도달할 때마다 비볼디 앱이 설치된 기기로 알림이 전송됩니다.
이 기능은 퍼스널 요금제 이상에서만 제공됩니다.
mailNotifyYnstring
Default:N
Enum:
YN
클릭 수 메일 알림 여부입니다. 값이 Y이면 [설정 -> 환경 설정]에서 지정한 클릭 수에 도달할 때마다 이메일로 알림이 전송됩니다.
이 기능은 퍼스널 요금제 이상에서만 제공됩니다.
delYmdtdatetime
링크 삭제 예약 일시입니다. 지정한 날짜가 지나면 링크는 시스템에 의해 자동으로 삭제됩니다.
예: 2025-08-30 23:59:59 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "shortUrl": "https://vvd.bz/bbuR",
            "url": "https://google.com"
        },
        {
            "shortUrl": "https://vvd.bz/bbuS",
            "url": "https://facebook.com"
        },
        {
            "shortUrl": "https://vvd.bz/bbuT",
            "url": "https://twitter.com"
        }
    ]
}

Response Parameters

codeinteger
응답 코드: 0 = 성공, 그 외 값 = 오류
messagestring
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
resultarray
응답 데이터입니다. 요청한 개수만큼 단축 URL이 배열 형태로 반환됩니다.