룩업 레코드 조회
지정한 룩업에 속한 레코드 목록을 조회합니다.
HTTP 요청
GET /api/sonar/lookups/:guid/records
요청 매개변수
경로 매개변수
| 키 | 타입 | 설명 | 비고 |
|---|---|---|---|
| guid | 문자열 | 룩업 GUID | 36자 |
요청 본문 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| offset | X | 32비트 정수 | 건너 뛸 갯수 | 기본값 0 |
| limit | X | 32비트 정수 | 최대 갯수 | 미지정 시 20건 |
| keywords | X | 문자열 | 검색 키워드 | 레코드 전체를 대상으로 검색 |
정상 응답
{
"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"
}