자료요청서비스
홈 > 생물자원DB > 자료요청서비스
생물종검색 Open API 라이브러리 다운로드 방법
- "자료요청 및 결과조회" 메뉴에서 "Open API 라이브러리 다운로드"를 클릭하여 jar 파일을 다운로드 받습니다. 단, 승인된 사용자에 한해 "다운로드" 버튼이 나타납니다.
- 조회된 결과는 json 형태로 반환됩니다.
요청 변수
| 제목 |
요청변수 |
값 |
설명 |
| 국명 |
taxon_knm |
string |
- 문, 강, 목, 과, 속, 종의 국명에 해당
- 국명은 Null 가능 |
| 학명 |
taxon_nm |
string |
문, 강, 목, 과, 속, 종의 분류체계명에 해당 |
| ktsn |
ktsn |
number |
KTSN번호 |
| ktsn_p |
ktsn |
number |
상위 KTSN번호 |
| 분류군 |
comm_group |
string |
생물분류군 코드
- - MM 포유류
- - AV 조류
- - RP 파충류
- - AM 양서류
- - -P 어류
- - CH 미삭동물류
- - IV 무척추동물(곤충제외)
- - IN 곤충류
- - VP 관속식물
- - MS 선태류
- - CR 윤조류
- - CL 녹조류
- - RR 홍조류
- - DI 규조류
- - FL 편모조류
- - CP 갈조류
- - FG 균류
- - LC 지의류
- - PR 원생동물류
- - ER 유글레나조류
- - CY 남조류
- - BA 세균
- - EA 고셰균류
- - AL 해조류
- - ND 정의안됨
|
| 정렬순서 |
sort_key |
string |
정렬기준값의 뒤에 _asc 또는 _desc를 붙여서 오름차순, 내림차순의 정렬을 지정한다.
- taxon_knm(국명)
- taxon_nm학명)
- ktsn(KTSN번호)
- p_ktsn(상위 KTSN번호)
(예) ktsn asc, ktsn desc
|
| 자료조회 페이지번호 |
page_index |
string |
자료조회시 페이지 번호 (Default : 1) |
| 자료조회 갯수 |
page_size |
string |
1회 호출시 가져올 갯수 (Default : 10) 최대 1,000건 |
개발 예제
<![CDATA[
String kbrSvrOpenApiAddr = "http://www.kbr.go.kr/com/openapi.do";
HashMap<String, String> hmap = new HashMap<String, String>();
hmap.put("access_key", "xxxxxxxx"); // kbr 사이트에서 발급된 access_key
// 검색조건 예제 (필요한 검색조건을 지정한다.)
hmap.put("taxon_knm" , "중개"); // 국명이 포함된 자료 검색
hmap.put("taxon_nm" , "czerskii"); // 학명이 포함된 자료 검색
hmap.put("ktsn" , "120000058184"); // KTSN 이 동일한 자료 검색
hmap.put("ktsn_p" , "1"); // 계단계자료 검색(최상위)
hmap.put("ktsn_p" , "120000058183"); // 특정 KTSN의 하위 자료 검색
hmap.put("comm_group" , "VP"); // 특정 분류군 자료 검색
hmap.put("sort_key" , "taxon_knm asc"); // 정렬키(taxon_knm asc, taxon_knm desc, taxon_nm asc, taxon_nm desc, ktsn asc, ktsn desc, ktsn_p asc, ktsn_p desc)
hmap.put("page_index" , "1"); // 자료 조회 페이지 번호
hmap.put("page_size" , "10"); // 자료 조회 사이즈(1번의 호출에 가져올 자료의 갯수)
String rtnVal = executeUrl(kbrSvrOpenApiAddr, hmap);
]]>
출력 결과 샘플
Json 샘플
<![CDATA[
hmap.put("ktsn_p", "1"); // 계단계자료 검색(최상위)
{ "bioList":
[
{ "total_cnt": "7", "sno": "1", "taxon_knm": "", "taxon_nm": "Animalia", "ktsn": "120000098390", "ktsn_p": "1", "comm_group_nm": "", "cls_step_nm": "계" },
{ "total_cnt": "7", "sno": "2", "taxon_knm": "", "taxon_nm": "Plantae", "ktsn": "120000098391", "ktsn_p": "1", "comm_group_nm": "", "cls_step_nm": "계" },
{ "total_cnt": "7", "sno": "3", "taxon_knm": "", "taxon_nm": "Heterokontophyta", "ktsn": "120000098392", "ktsn_p": "1", "comm_group_nm": "", "cls_step_nm": "계" },
{ "total_cnt": "7", "sno": "4", "taxon_knm": "", "taxon_nm": "Fungi", "ktsn": "120000098393", "ktsn_p": "1", "comm_group_nm": "", "cls_step_nm": "계" },
{ "total_cnt": "7", "sno": "5", "taxon_knm": "", "taxon_nm": "Protozoa", "ktsn": "120000098394", "ktsn_p": "1", "comm_group_nm": "", "cls_step_nm": "계" },
{ "total_cnt": "7", "sno": "6", "taxon_knm": "", "taxon_nm": "Eubacteria", "ktsn": "120000098395", "ktsn_p": "1", "comm_group_nm": "", "cls_step_nm": "계" },
{ "total_cnt": "7", "sno": "7", "taxon_knm": "", "taxon_nm": "Archaea", "ktsn": "120000098396", "ktsn_p": "1", "comm_group_nm": "", "cls_step_nm": "계" }
]
}
hmap.put("ktsn_p", "120000098391"); // 위 검색결과에서 Plantae 자료의 하위자료 검색
{ "bioList":
[
{ "total_cnt": "14", "sno": "1", "taxon_knm": "녹조식물문", "taxon_nm": "Chlorophyta", "ktsn": "120000000001", "ktsn_p": "120000098391", "comm_group_nm": "담수녹조류", "cls_step_nm": "문" },
{ "total_cnt": "14", "sno": "2", "taxon_knm": "홍조식물문", "taxon_nm": "Rhodophyta", "ktsn": "120000000491", "ktsn_p": "120000098391", "comm_group_nm": "", "cls_step_nm": "문" },
{ "total_cnt": "14", "sno": "3", "taxon_knm": "윤조식물문", "taxon_nm": "Charophyta", "ktsn": "120000005673", "ktsn_p": "120000098391", "comm_group_nm": "윤조류", "cls_step_nm": "문" },
{ "total_cnt": "14", "sno": "4", "taxon_knm": "선태식물문", "taxon_nm": "Bryophyta", "ktsn": "120000053472", "ktsn_p": "120000098391", "comm_group_nm": "선태류", "cls_step_nm": "문" },
{ "total_cnt": "14", "sno": "5", "taxon_knm": "우산이끼문", "taxon_nm": "Marchantiophyta", "ktsn": "120000054027", "ktsn_p": "120000098391", "comm_group_nm": "선태류", "cls_step_nm": "문" },
{ "total_cnt": "14", "sno": "6", "taxon_knm": "각태식물문", "taxon_nm": "Anthocerophyta", "ktsn": "120000054836", "ktsn_p": "120000098391", "comm_group_nm": "선태류", "cls_step_nm": "문" },
{ "total_cnt": "14", "sno": "7", "taxon_knm": "양치식물문", "taxon_nm": "Pteridophyta", "ktsn": "120000059509", "ktsn_p": "120000098391", "comm_group_nm": "관속식물", "cls_step_nm": "문" },
{ "total_cnt": "14", "sno": "8", "taxon_knm": "나자식물문", "taxon_nm": "Pinophyta", "ktsn": "120000059926", "ktsn_p": "120000098391", "comm_group_nm": "관속식물", "cls_step_nm": "문" },
{ "total_cnt": "14", "sno": "9", "taxon_knm": "현화식물문", "taxon_nm": "Magnoliophyta", "ktsn": "120000060027", "ktsn_p": "120000098391", "comm_group_nm": "관속식물", "cls_step_nm": "문" },
{ "total_cnt": "14", "sno": "10", "taxon_knm": "", "taxon_nm": "Lycopodiophyta", "ktsn": "120000065856", "ktsn_p": "120000098391", "comm_group_nm": "관속식물", "cls_step_nm": "문" }
]
}
hmap.put("taxon_knm", "중개"); // 국명이 중개가 포함된 자료검색
{ "bioList":
[
{ "total_cnt": "7", "sno": "1", "taxon_knm": "둑중개과", "taxon_nm": "Cottidae", "ktsn": "120000058175", "ktsn_p": "120000058049", "comm_group_nm": "어류", "cls_step_nm": "과" },
{ "total_cnt": "7", "sno": "2", "taxon_knm": "둑중개속", "taxon_nm": "Cottus", "ktsn": "120000058183", "ktsn_p": "120000067140", "comm_group_nm": "어류", "cls_step_nm": "속" },
{ "total_cnt": "7", "sno": "3", "taxon_knm": "참둑중개", "taxon_nm": "czerskii", "ktsn": "120000058184", "ktsn_p": "120000058183", "comm_group_nm": "어류", "cls_step_nm": "종" },
{ "total_cnt": "7", "sno": "4", "taxon_knm": "한둑중개", "taxon_nm": "hangiongensis", "ktsn": "120000058185", "ktsn_p": "120000058183", "comm_group_nm": "어류", "cls_step_nm": "종" },
{ "total_cnt": "7", "sno": "5", "taxon_knm": "둑중개", "taxon_nm": "koreanus", "ktsn": "120000058186", "ktsn_p": "120000058183", "comm_group_nm": "어류", "cls_step_nm": "종" },
{ "total_cnt": "7", "sno": "6", "taxon_knm": "둑중개과", "taxon_nm": "Cottidae", "ktsn": "120000067140", "ktsn_p": "120000067134", "comm_group_nm": "어류", "cls_step_nm": "과" },
{ "total_cnt": "7", "sno": "7", "taxon_knm": "둑중개", "taxon_nm": "poecilopus", "ktsn": "120000080587", "ktsn_p": "120000058183", "comm_group_nm": "어류", "cls_step_nm": "종" } ]}
]
}
]]>
