용어 일괄 삭제

용어를 일괄 삭제합니다. 이 작업은 관리자 권한을 요구합니다.

필요 권한

관리자 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d guids="5ad13151-dbc1-41c0-92a7-dfeb5f534f4c,77e0aa85-14d3-43a9-ab23-4dc97dfc185e" \
     -X DELETE "https://HOSTNAME/api/sonar/glossary/terms"

요청 매개변수

정상 응답

{
  "failures": []
}

• failures (배열): 실패한 GUID 및 사유 목록 (없으면 빈 배열)

오류 응답

필수 매개변수가 누락된 경우

HTTP 상태코드 400 응답

{
  "error_code": "null-argument",
  "error_msg": "guids parameter is required."
}

용어가 존재하지 않는 경우

HTTP 상태 코드 200 응답

{
  "failures": [
    {
      "id": "54157629-74f7-4d80-be5a-8cb8f0c71087",
      "reason": "term-not-found [guid: 54157629-74f7-4d80-be5a-8cb8f0c71087]"
    }
  ]
}

중복된 GUID가 포함된 경우

HTTP 상태 코드 200 응답

{
  "failures": [
    {
      "id": "5ad13151-dbc1-41c0-92a7-dfeb5f534f4c",
      "reason": "duplicated-parameter [guid: 5ad13151-dbc1-41c0-92a7-dfeb5f534f4c]"
    }
  ]
}

식별자가 GUID 형식이 아닌 경우

HTTP 상태코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "guids should be guid type."
}

관리 권한이 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}