링크 수정

생성된 단축 URL 정보를 수정하는 API입니다.

링크 유형이 URL인 경우에만 허용되며, 다른 유형(게시물 링크, Form 링크, 버튼 링크 등)은 API를 호출해도 반영되지 않습니다.

PUT

/api/link/v2/update 

{
    "linkId": "4Rt3",
    "domain": "https://vvd.bz",
    "ttl": "new title",
    "memo": "new my memo"
}

Request Parameters

linkIdstringrequired
링크ID. URL이 “https://vvd.bz/fML”이면 링크ID는 fML 입니다.
domainstringrequired
Default:https://vvd.bz
링크 도메인.
redirectTypeinteger
Default:302
Enum:
200301302
Redirect 방식. 자세한 내용는 주요 용어 페이지에서 확인하세요.
이 기능은 퍼스널 요금제 이상에서만 제공됩니다.
grpIdxinteger
링크를 그룹화할 때 사용됩니다. 그룹IDX는 그룹 목록 API를 호출하거나 대시보드에서 확인할 수 있습니다.
urlstring
원본 URL. 최대 3,000 bytes까지 입력 가능합니다.
이 기능은 프리미엄 요금제 이상에서만 제공됩니다.
ttlstring
링크 제목.
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": null
}

Response Parameters

codeinteger
응답 코드: 0 = 성공, 그 외 값 = 오류
messagestring
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
resultnull