링크 삭제 API

생성된 단축 링크를 영구적으로 삭제하는 API입니다.

삭제된 링크는 복구할 수 없으며, 삭제 즉시 해당 단축 URL로의 접속이 차단됩니다.
삭제 전 반드시 링크 사용 여부를 확인하세요.

중요한 링크의 경우, 삭제 후 다시 복구가 가능한 브랜드 링크(링크 ID를 직접 설정)로 생성하세요.

불필요한 링크 정리나 접근 차단이 필요한 경우 사용됩니다.

DELETE

/api/link/v1/delete?linkId={linkId}&domain={domain} 


DELETE /api/link/v1/delete
        ?linkId=4Rt3
        &domain=https%3A%2F%2Fvvd.bz

Request Parameters

linkId string required
링크ID. URL이 “https://vvd.bz/fML”이면 링크ID는 fML 입니다.
domain string required
Default:https://vvd.bz
링크 도메인. 
{
    "code": 0,
    "message": "",
    "result": null
}

Response Parameters

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

언제 이 API를 사용하나요?

다음과 같은 상황에서 링크 삭제 API를 사용합니다.

  • 종료된 이벤트나 캠페인의 단축 링크를 정리할 때
  • 잘못 생성된 링크를 제거해야 할 때
  • 보안상 더 이상 유효하지 않아야 하는 링크를 즉시 차단해야 할 때
  • 링크 수를 관리하여 계정을 정리할 때
삭제된 링크는 즉시 무효화되며, 기존에 공유된 URL도 더 이상 동작하지 않습니다.
단순히 목적지 URL을 변경하고 싶은 경우라면 삭제 대신 링크 수정 API(Update API)를 사용하는 것을 권장합니다.

링크 수정 API와 차이점

링크 삭제 API는 링크를 완전히 제거하는 기능이며, 링크 수정 API와 다음과 같은 차이가 있습니다.

  • 삭제: 단축 링크 자체가 완전히 제거됩니다. 삭제 후 해당 링크로 접속하면 오류 페이지가 표시되며 복구가 불가능합니다.
  • 수정: 링크 주소는 유지된 채 원본 URL이나 설정만 변경됩니다. 이미 공유된 링크를 무효화하지 않습니다.

삭제 시 영향 범위

링크 삭제 시 다음과 같은 영향이 발생합니다.

  • 해당 단축 URL 즉시 비활성화
  • 기존 접근 시 오류 또는 페이지 미표시
  • 연결된 통계 데이터 조회 제한 가능
  • 외부에 공유된 링크 모두 무효 처리
삭제는 되돌릴 수 없으므로 신중하게 수행해야 합니다.

사용 시 주의사항

삭제 작업은 되돌릴 수 없으므로 다음 사항을 확인하세요.

  • linkId와 domain이 정확한지 확인
  • 삭제 후 복구 불가
  • 중요한 링크는 brandLinkId로 직접 링크 ID를 설정하여 생성 권장
  • 대량 삭제 시 영향 범위 사전 검토 필요
운영 환경에서는 삭제 권한을 제한하는 것을 권장합니다.