룩업 레코드 조회

지정한 룩업에 속한 레코드 목록을 조회합니다.

HTTP 요청

GET /api/sonar/lookups/:guid/records
요청 매개변수
경로 매개변수
타입설명비고
guid문자열룩업 GUID36자
요청 본문 매개변수
필수타입설명비고
offsetX32비트 정수건너 뛸 갯수기본값 0
limitX32비트 정수최대 갯수미지정 시 20건
keywordsX문자열검색 키워드레코드 전체를 대상으로 검색

정상 응답

{
  "total_count": 236,
  "fields": [
    "country",
    "name"
  ],
  "records": [
    ["AE", "아랍에미리트 연합국"],
    ["AF", "아프카니스탄"],
    ["AG", "안티가 부다"],
    ["AI", "안굴라"],
    ["AL", "알바니아"],
    ["AM", "아르메니아"],
    ["AN", "안틸레스"],
    ["AO", "앙골라"],
    ["AQ", "남극지역"],
    ["AR", "아르엔티나"],
    ["AS", "미국령 사모아"],
    ["AT", "오스트리아"],
    ["AU", "호주"],
    ["AW", "아루바"],
    ["AZ", "아제르바이잔"],
    ["BA", "보스니아-헤르체고비아"],
    ["BB", "바베이도스"],
    ["BD", "방글라데시"],
    ["BE", "벨기에"],
    ["BF", "부르키나파소"]
  ]
}
  • total_count (32비트 정수): 검색 조건과 일치하는 전체 룩업 레코드 수
  • fields (배열): 필드 이름 목록
  • records (배열): 레코드 목록

오류 응답

offset, limit 값이 정수가 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'offset' parameter should be int type"
}
offset, limit 값이 음수인 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-argument",
  "error_msg": "'offset' must be greater than or equal to 0."
}
룩업 레코드 조회 권한이 없는 경우

HTTP 상태 코드 500 응답

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