링크 수정

Request Parameters

linkId string required

링크ID. URL이 “https://vvd.bz/fML”이면 링크ID는 fML 입니다.

domain string required

Default:https://vvd.bz

링크 도메인.

redirectType integer

Default:302

Enum:

200301302

Redirect 방식. 자세한 내용는 주요 용어 페이지에서 확인하세요.
이 기능은 퍼스널 요금제 이상에서만 제공됩니다.

grpIdx integer

링크를 그룹화할 때 사용됩니다. 그룹IDX는 그룹 목록 API를 호출하거나 대시보드에서 확인할 수 있습니다.

url string

원본 URL. 최대 3,000 bytes까지 입력 가능합니다.
이 기능은 프리미엄 요금제 이상에서만 제공됩니다.

ttl string

링크 제목.

description string

redirectType 값이 200일 경우, description 메타 태그를 설정할 수 있습니다.

metaImg string

redirectType 값이 200일 경우, image 메타 태그를 설정할 수 있습니다.
이미지 URL은 반드시 https://로 시작해야 합니다.

memo string

링크 관리용 메모입니다.

notfSubscYn string

Default:N

Enum:

YN

푸시구독 링크 여부입니다. 값이 Y이면 원본 URL로 이동되기 전에 랜딩 페이지가 열리며, 사용자에게 푸시 알림 권한을 요청합니다.
사용자가 권한을 거부하거나 취소하면 즉시 원본 URL로 이동됩니다.

qrBypassYn string

Default:N

Enum:

YN

QR 코드 스캔 시 단축 URL을 거치지 않고, 사용자가 설정한 원본 URL로 직접 이동할지 여부를 제어합니다.
Y: 단축 URL을 거치지 않고 원본 URL로 직접 이동합니다. (QR 스캔 통계 미기록)
N: 단축 URL을 거친 후 원본 URL로 이동합니다. (QR 스캔 통계 기록됨)

blockOverseasSticsYn string

Default:N

Enum:

YN

해외통계 차단 여부입니다. 한국 외 국가에서 접속하면 클릭 수는 집계되지 않습니다.

pushNotifyYn string

Default:N

Enum:

YN

클릭 수 푸시 알림 여부입니다. 값이 Y이면 대시보드의 [설정 -> 환경 설정]에서 지정한 클릭 수에 도달할 때마다 비볼디 앱이 설치된 기기로 알림이 전송됩니다.
이 기능은 퍼스널 요금제 이상에서만 제공됩니다.

mailNotifyYn string

Default:N

Enum:

YN

클릭 수 메일 알림 여부입니다. 값이 Y이면 [설정 -> 환경 설정]에서 지정한 클릭 수에 도달할 때마다 이메일로 알림이 전송됩니다.
이 기능은 퍼스널 요금제 이상에서만 제공됩니다.

webhookEnableYn string

Default:N

Enum:

YN

Webhook 사용 여부. 전역 Webhook이 활성화되어 있어야 합니다.
이 기능은 엔터프라이즈 요금제에서만 제공됩니다.

webhookMetric string

Default:C

Enum:

CP

Webhook 수신 기준. C:클릭 수 기준, P:사람 수 기준(고유 클릭 수)

webhookFrequency integer

Default:1

Enum:

1501002003005001000

Webhook 수신 주기. 1:매번 클릭 시, 50:50회 마다, 100:100회 마다, 300:300회 마다, 500:500회 마다, 1000:1,000회 마다

delYmdt datetime

링크 삭제 예약 일시입니다. 지정한 날짜가 지나면 링크는 시스템에 의해 자동으로 삭제됩니다.
예: 2025-08-30 23:59:59