링크 그룹 삭제 API

불필요한 링크 그룹을 삭제하는 API입니다.

그룹에 포함된 링크는 삭제되지 않고 유지되므로, 구조만 정리할 때 안전하게 사용할 수 있습니다.

DELETE

/api/link-group/v1/delete?grpIdx={grpIdx} 


DELETE /api/link-group/v1/delete
        ?grpIdx=5066

Request Parameters

grpIdx integer required
삭제할 링크 그룹의 IDX입니다. 
{
    "code": 0,
    "message": "",
    "result": null
}

Response Parameters

code integer
응답 코드: 0 = 성공, 그 외 값 = 오류
message string
응답 메시지입니다. 응답 코드가 0이 아니면, 오류 관련 메시지가 반환됩니다.
result null

언제 이 API를 사용하나요?

운영이 끝난 링크 그룹을 정리할 때 사용합니다.

종료된 캠페인 그룹을 제거하거나, 개발·테스트 과정에서 생성한 임시 그룹을 삭제할 때 활용합니다.

기존 그룹 구조를 해체하고 새로운 구조로 재편할 때도 유용합니다.
링크 자체는 유지하면서 그룹만 제거할 수 있어 운영 중인 링크에 영향을 주지 않습니다.

그룹 삭제와 링크 삭제의 차이점

링크 삭제 API는 링크 자체를 제거하여 해당 단축 URL에 접근할 수 없게 만듭니다.
반면 링크 그룹 삭제 API는 그룹 구조만 제거하며 링크는 그대로 유지됩니다.

링크 데이터를 완전히 제거해야 한다면 링크 삭제 API를, 관리 구조만 정리하고 싶다면 링크 그룹 삭제 API를 사용하세요.

삭제 시 동작 방식

이 API는 “데이터 삭제”가 아니라 그룹 구조 제거에 가깝습니다.

  • 그룹만 삭제됨
  • 그룹에 포함된 링크는 그대로 유지됨
  • 링크는 그룹이 없는 상태로 변경됨

링크의 리디렉션과 통계 수집 등 실제 동작에는 영향을 주지 않습니다.
단, 그룹에 적용되어 있던 유효기간, 비밀번호, 웹훅 등의 공통 설정은 함께 제거됩니다.

사용 시 주의사항

  • 삭제된 그룹은 복구할 수 없습니다. 삭제 전 grpIdx를 반드시 확인하세요
  • 그룹에 속한 링크는 삭제되지 않습니다
  • 그룹 기반 설정이 있었다면 해당 설정은 제거됩니다
  • 운영 중인 링크가 그룹에 의존하고 있었다면 영향이 발생할 수 있습니다

사전에 링크별 설정을 개별 적용한 뒤 그룹을 삭제하는 것을 권장합니다.