링크 그룹 수정

링크 그룹의 설정을 수정하는 API입니다.
링크 그룹은 여러 단축 링크를 하나의 그룹으로 묶어 관리하는 기능입니다.

이미 생성된 링크 그룹의 이름이나 설정을 변경해야 할 때 이 API를 사용할 수 있습니다.
유효기간, 클릭 제한, 비밀번호, 알림, 통계 설정 등 다양한 옵션을 그룹 단위로 수정하여 관리할 수 있습니다.

그룹 설정이 변경되면 해당 그룹에 포함된 모든 링크에 변경된 설정이 적용됩니다.
개별 링크 설정과 그룹 설정이 중복될 경우 그룹 설정이 우선 적용됩니다.

링크를 캠페인, 프로젝트, 마케팅 채널 등 목적에 맞게 그룹으로 관리하면 그룹 단위 통계 분석과 링크 운영을 더욱 효율적으로 유지할 수 있습니다.

PUT

/api/link-group/v1/update

{
    "grpIdx": 5066,
    "nm": "Instagram Group",
    "memo": "A group of links used in Instagram ads.",
    "strtYmdt": "2026-03-01 00:00:00",
    "endYmdt": "2026-03-31 23:59:59",
    "expireUrl": "https://example.com/event-expired"
}

Request Parameters

grpIdx integer required
그룹 IDX입니다. 수정할 그룹 IDX 값을 지정합니다.
nm string
그룹 이름입니다. 링크를 분류하고 관리하기 위한 그룹의 이름을 설정합니다.
memo string
그룹 관리용 메모입니다. 그룹의 목적이나 관리 정보를 자유롭게 기록할 수 있습니다.
notfSubscYn string
Default:N
Enum:
YN
푸시 구독 링크 여부를 설정합니다.
Y: 푸시 구독 전용 링크로 생성됩니다, N: 일반 링크로 생성됩니다.
푸시 구독 전용 링크는 사용자가 링크에 접속하면 웹 푸시 알림 구독 요청이 표시됩니다.
qrBypassYn string
Default:N
Enum:
YN
QR 코드 접속 시 이동 방식 설정입니다.
Y: QR 코드 접속 시 원본 URL로 바로 이동합니다. (클릭 통계 미기록)
N: QR 코드 접속 시 짧은 링크 URL로 이동합니다. (클릭 통계 기록됨)
blockOverseasSticsYn string
Default:N
Enum:
YN
해외 접속 통계 차단 여부를 설정합니다.
Y: 해외 접속은 통계에 포함되지 않습니다.
N: 모든 국가의 접속이 통계에 포함됩니다.
pushNotifyYn string
Default:N
Enum:
YN
클릭 수 푸시 알림 여부를 설정합니다.
Y: 설정한 기준에 도달하면 푸시 알림이 전송됩니다.
N: 푸시 알림이 전송되지 않습니다.
이 기능은 퍼스널 요금제 이상에서만 제공됩니다.
mailNotifyYn string
Default:N
Enum:
YN
클릭 수 이메일 알림 여부를 설정합니다.
Y: 설정한 기준에 도달하면 이메일 알림이 전송됩니다.
N: 이메일 알림이 전송되지 않습니다.
이 기능은 퍼스널 요금제 이상에서만 제공됩니다.
nonmemberSticsPwd string
비회원 클릭 수 조회 비밀번호입니다.
비회원 사용자에게 클릭 통계를 공개하려는 경우, 통계 페이지 접근 시 입력해야 하는 비밀번호를 설정합니다.
strtYmdt datetime
링크 유효기간 시작 날짜입니다. 설정한 날짜 이후부터 링크 접속이 허용됩니다.
예: 2026-03-01 00:00:00
endYmdt datetime
링크 유효기간 만료 날짜입니다. 설정한 날짜 이후에는 링크 접속이 차단됩니다. 예: 2026-03-31 23:59:59
expireUrl string
링크 유효기간이 만료된 후 이동할 URL입니다. 설정하지 않으면 기본 안내 페이지가 표시됩니다.
예: https://example.com/event-expired
pwd string
링크 접근 비밀번호입니다.
설정된 경우 사용자는 링크 접속 시, 비밀번호를 입력해야 목적 페이지로 이동할 수 있습니다.
acesMaxCnt integer
최대 클릭 허용 횟수입니다.
설정한 횟수를 초과하면 링크 접속이 차단됩니다. (0 값은 제한없음)
webhookEnableYn string
Default:N
Enum:
YN
Webhook 사용 여부. 전역 Webhook이 활성화되어 있어야 합니다.
이 기능은 엔터프라이즈 요금제에서만 제공됩니다.
webhookCallbackUrl string
Webhook 이벤트를 수신할 서버 URL입니다.
webhookEnableYn 값이 Y일 때 필수 값이며, 사용자의 서버에서 이벤트 데이터를 수신할 엔드포인트를 입력합니다.
예: https://api.example.com/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회 마다
{
    "code": 0,
    "message": "",
    "result": null  // When the ‘webhookEnableYn’ parameter is set to ‘Y’, a secret key is specified.
}

Response Parameters

code integer
응답 코드: 0 = 성공, 그 외 값 = 오류
message string
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
result string
webhookEnableYn 값이 Y이면 secret key가 생성되어 전달됩니다.
이미 webhookSecretKey가 존재하는 경우에는 새로 생성되지 않으며 전달되지 않습니다.