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

링크 수정

생성된 단축 URL의 정보를 수정하는 API입니다.
링크 유형이 URL인 경우에만 수정이 가능하며,
그 외의 유형(게시물 링크, Form 링크, 버튼 링크, 카드 링크 등)은 수정 요청을 보내더라도 값이 반영되지 않습니다.

Http Header 
PUT /api/link/v2/update
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: application/json
User-agent: {Your User-agent}
Accept-Language: en
Request 
{
	"linkId": "4Rt3",
	"domain": "https://vvd.bz",
	"ttl": "new title",
	"memo": "new my memo"
}
필드필드 설명설명필수유형
linkId링크ID 생성된 짧은 링크의 ID
예:
짧은 링크의 주소가 "https://vvd.bz/fML"이면 링크ID는 fML 입니다. 		string
domain도메인 짧은 링크 주소의 도메인.
예:
짧은 링크의 주소가 "https://vvd.bz/fML"이면 도메인은 https://vvd.bz 입니다.
중요: https:// 또는 http:// 값을 반드시 입력해야 합니다.
생성된 짧은 링크의 도메인이 아닌 다른 도메인으로 설정할 경우 오류가 발생합니다. 		string
redirectTypeRedirect 방법 짧은 URL에서 긴 URL로 이동되는 방식을 설정합니다.
HTTP의 상태 응답 코드로 200, 301, 302 중에 하나를 선택할 수 있습니다. 기본 값: 302
Redirect 방법에 대한 자세한 내용는 “용어 정리” 페이지에서 확인하세요. 		int
grpIdx그룹ID 생성된 링크의 그룹을 변경합니다.
그룹ID를 확인하려면 "그룹 목록" API를 호출하여 확인해야 합니다. 		int
url긴 URL 긴 URL을 변경합니다.
프리미엄 요금제부터 긴 URL을 변경할 수 있습니다. 		string
ttl링크 제목 값이 비어 있으면 링크 제목이 수정되지 않습니다.
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": null
}
필드설명유형
code응답 코드 (0:성공)int
message응답 메시지, 응답 코드가 0이 아닐 경우 관련 메시지가 리턴됨.string