링크 그룹 수정 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가 존재하는 경우에는 새로 생성되지 않으며 전달되지 않습니다.

언제 이 API를 사용하나요?

여러 개의 링크를 개별적으로 수정하기 어려운 상황에서 사용합니다.

  • 광고 캠페인 링크를 한 번에 비활성화하거나 기간을 변경해야 할 때
  • 특정 이벤트 종료 후 전체 링크의 접근을 제한해야 할 때
  • 동일한 설정을 여러 링크에 일괄 적용해야 할 때
링크를 하나씩 수정하는 대신 그룹 단위로 처리할 수 있어 운영 부담을 줄일 수 있습니다.

주요 기능 및 설정 영향

이 API는 단순 수정이 아니라 운영 정책을 변경하는 역할을 합니다.

접근 제어 설정

  • 비회원 접근 제한
  • QR 코드 접근 제한 → 특정 사용자만 접근 가능하도록 제어

통계 및 필터링

  • 봇 통계 제외 여부 설정 → 데이터 정확도에 직접적인 영향

알림 설정

  • 푸시 / 이메일 알림 → 링크 이벤트 발생 시 실시간 대응 가능

기간 설정

  • 시작일 / 종료일 설정 → 자동 활성화 / 비활성화 처리

만료 처리

  • 만료 시 이동할 URL 지정 → 사용자 경험 유지

Webhook 설정

  • 이벤트 발생 시 외부 서버로 데이터 전송 → 시스템 연동 및 자동화 가능

활용 예시

  • 마케팅 캠페인: 이벤트 종료 시 그룹 전체 링크를 비활성화하고 만료 URL로 자동 이동하도록 설정
  • SaaS 서비스: 기능별 링크를 그룹으로 묶고 접근 권한 및 기간을 중앙에서 제어
  • 대량 링크 운영: Webhook과 함께 사용하여 클릭 이벤트를 내부 시스템과 실시간 연동
  • 보안 관리: 비밀번호를 일정 주기로 변경해 보안 유지

사용 시 주의사항

  • 그룹 설정 변경 시 모든 링크에 즉시 반영됩니다
  • 잘못된 기간 설정 시 전체 링크 접근이 제한될 수 있습니다
  • Webhook 설정 시 외부 서버 상태에 따라 처리 지연이 발생할 수 있습니다
  • 통계 필터링 설정 변경 시 기존 데이터 해석 기준이 달라질 수 있습니다