본문 바로가기

산림과학도서관 - 검색 데이터 - OpenAPI 서비스명세

관련문의 | 연구기획과 김근희, 02-961-2586

사용설명

사이버도서관의 자료에서 입력한 소장기관, 검색종류, 검색구분, 검색어, 자료유형로 검색을 수행합니다.
검색결과의 내용을 포함하고 있는 컨텐츠번호를 상세API에 요청해서 내용을 확인할 수 있는 기능을 위해서 사용됩니다.

요청 URL(request url)

http://know.nifos.go.kr/openapi/cyberLib/totalSearch.do?요청변수=값

요청 변수(request parameter)

요청 변수
No 요청변수 설명
1 keyValue String(필수) 발급된 인증키
2 version String(필수) OpenAPI 버전 (현재 1.0)
3 searchType String 검색종류 (범위: keyword, start_with, match)
   keyword : 키워드
   start_with : 상단일치
   match : 완전일치
4 searchGbn String 검색구분 (범위: TITL ~ ALL)
   ALL : 전체
   TITL : 서명
   AUTH : 저자
   SUBJ : 주제
   PUBN : 출판사
   CLAS : 분류번호
   CA : 청구기호
   DONA: 기증자
   ISBN : ISBN
   ISSN : ISSN
   LCCN : LCCN
   IDID : 등록번호
   CID : 콘텐츠번호
   TOC : 목차
5 searchPyb String 발행기간(시작일)
6 searchPye String 발행기간(종료일)
7 searchValue String 검색어
8 searchMetaType String 자료유형
      researchData: 연구자료
      researchLetter: 연구신서
      researchReport: 연구보고
      forestBrData: 산림과학속보
      etcData: 기타간행물
      bookData: 단행본
      promoteData: 홍보간행물
      newsIndex: 기사색인
9 startPage Integer 페이지 시작번호, default: 1
10 displayCnt Integer 디스플레이 건수, default: 10

샘플 URL

검색종류(키워드), 검색구분(서명), 검색어(산림), 자료유형(전체) 페이지 시작번호(1), 디스플레이 건수(3) 자료 검색:
http://know.nifos.go.kr/openapi/cyberLib/totalSearch.do?keyValue=5616322344776229063796515611583064046076 &version=1.0&searchType=keyword&searchGbn=TITL&searchValue=산림&searchMetaType=researchData&startPage=1&displayCnt=3
※ URL(한글)은 반드시 인코딩해야 함

출력결과 필드(response field)

출력결과 필드 (response field)
No 항목 Xpath 설명
1 /MetaData/inputData/keyvalue 인증키 (Parameter)
2 /MetaData/inputData/version 버전 (Parameter)
3 /MetaData/inputData/searchType 검색 종류 (Parameter)
4 /MetaData/inputData/searchGbn 검색 구분 (Parameter)
5 /MetaData/inputData/searchValue 검색어 (Parameter)
6 /MetaData/inputData/searchMetaType 자료유형 (Parameter)
7 /MetaData/inputData/searchPyb 발행기간 시작일(Parameter)
8 /MetaData/inputData/searchPye 발행기간 종료일(Parameter)
9 /MetaData/inputData/startPage 페이지 시작번호 (Parameter)
10 /MetaData/inputData/displayCnt 디스플레이 건수 (Parameter)
11 /MetaData/outputData/items/@cid 컨텐츠 번호
12 /MetaData/outputData/items/metaType 자료유형
13 /MetaData/outputData/items/signature 서명
14 /MetaData/outputData/items/pubOrganYear 발행기관/연도
15 /MetaData/outputData/items/hasOrgan 소장기관
16 /MetaData/outputData/items/appMark 청구기호
17 /MetaData/outputData/items/borrowYn 대출여부
18 /MetaData/outputData/items/thumb 썸네일

출력 결과 XML

<?xml version="1.0" encoding="UTF-8" ?>
<MetaData>
</resultSummary>
<inputData>
<keyvalue>5616322344776229063796515611583064046076</keyvalue>
<version>1.0</version>
</searchOrgan>
<searchType>keyword</searchType>
<searchGbn>TITL</searchGbn>
<searchValue>산림</searchValue>
</searchMetaType>
<startPage>1</startPage>
<displayCnt>2</displayCnt>
</inputData>
<outputData>
<items cid="29397">
<metaType>국내대내단행본</metaType>
<signature>희귀 산림유전자원 시로미의 보존 및 자원화 국립산림과학원 난대산림연구소/국립산림과학원
난대산림연구소,국립산림과학원 난대산림연구소</signature>
<pubOrgan>국립산림과학원 난대산림연구소 2004</pubOrgan>
<hasOrgan>국립산림과학원 난대산림연구소</hasOrgan>
<appMark>634.956 국239ㅎ</appMark>
<borrowYn>대출가능</borrowYn>
</items>
<items cid="159727">
<metaType>국내대내단행본</metaType>
<signature>희귀 및 특산 산림식물 유전자원 보존을 위한 표본추출 지침서 개발/ 고려대학교/고려대학교,
산림청</signature>
<pubOrgan>산림청, 2012</pubOrgan>
<hasOrgan>산림청</hasOrgan>
<appMark>607.2 고294희</appMark>
<borrowYn>대출가능</borrowYn>
<thumb>http://152.99.88.238/thumbnail//000/159/tn_00159727.jpg</thumb>
</items>
</outputData>
</MetaData>