용어 조회

지정한 용어를 조회합니다.

필요 권한

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

HTTP 요청

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     "https://HOSTNAME/api/sonar/glossary/terms/:guid"

요청 매개변수

정상 응답

{
  "term": {
    "guid": "a07e6bd4-5ca2-11f0-ad90-acde48001122",
    "locale": "ko",
    "term": "시각",
    "type": "DATE",
    "code": "_time",
    "category": "field",
    "description": "로그 생성 시각",
    "created": "2025-07-01 00:31:13+0900",
    "updated": "2025-07-01 00:31:13+0900"
  }
}

• term (맵): 용어 정보
  • guid (문자열): 용어 GUID
  • locale (문자열): 언어. ko(한국어), en(영어), zh(중국어) 중 하나
  • term (문자열): 용어
  • type (문자열): 데이터 유형 (DATE, STRING, IP, PORT, SHORT, INT, LONG, COUNTRY, FLOAT, DOUBLE, BOOL, MD5, SHA1, URL, SHA256, DOMAIN 중 하나)
  • code (문자열): 용어 식별 코드
  • category (문자열): 용어 사용 대상 분류 (table, field 중 하나)
  • description (문자열): 용어 설명
  • created (문자열): 생성일시 (yyyy-MM-dd HH:mm:ssZ 형식)
  • updated (문자열): 수정일시 (yyyy-MM-dd HH:mm:ssZ 형식)

오류 응답

용어가 존재하지 않는 경우

HTTP 상태 코드 200 응답

{
  "term": null
}

guid가 GUID 형식이 아닌 경우

HTTP 상태코드 400 응답

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