도서관안내

OpenAPI 이용안내

검색 API

URL

http://IP:PORT/Home Directory/Manager/OpenApi.do?USERID=[작업자ID]&className=action.lnk.LnkSearchList&vSysdiv=[검색시스템]&vSType=[검색방식]&vSrchKey1=[검색항목]&vSrchText1=[검색어]&vStartPos=[시작위치]&vEndPos=[종료위치]

요청변수 (필수)

요청변수 (필수)
요청변수 설명
USERID string (필수) WEB
className string (필수) action.lnk.LnkSearchItem
vSysdiv string (필수) 검색시스템(TOT, CAT 등)
vSType string (필수) 검색방식(키워드[KWRD], 전방일치[FRNT], 완전일치[EXCT]) - 기본 키워드
vSrchKey+숫자
(검색 갯수별로 숫자+1)
string 검색항목
vSrchText+숫자
(검색 갯수별로 숫자+1)
string (가나다 검색이 아닐시 필수) 검색어
vSrchOp+숫자
(검색 갯수별로 숫자+1)
string 조합조건( AND, OR )
- vSrchOp1 : vSrchText1과 vSrchText2 의 조합…
vLmt+dsLimituse출력순서 string 제한검색(자료유형, 언어, 소장처)
- action.lnk.LnkSearchMain에서 조회한 dsLimituse 순서대로 보냄
- 다중선택일 경우 구분자(';')로 구분
vIncType string 수록매체
- 다중선택일 경우 구분자(';')로 구분
vPubStDt+숫자
(검색 갯수별로 숫자+1)
string 발행년 시작일
vPubEndDt+숫자
(검색 갯수별로 숫자+1)
string 발행년 종료일
vStartPos string 페이지의 시작 위치
vEndPos string 페이지의 마지막 위치 (기본 10)
vFacet+(NUM) string 패싯(패싯 넘어오는 정보의 NUM을 붙여준다)
- 배열로 넘어올경우 구분자(';')로 구분
VRefine string 결과내 재검색 여부(Y/N)
- 이전 검색 파라미터와 재검색될 파라미터조건을 같이 보내준다.
vAq string 가나다 검색어(해당 파라미터에 값이 있을시 가나다 검색이 됨)
- (a~z / ㄱ~ㅎ / TOTAL / ETC)
vNDt string(신착도서조회 필수) 신착기간 기간
vOS string 정렬필드(dsDispColl의 VALUE 값 출력)
vOI string 정렬방식(ASC/DESC)

출력 XML

출력 XML
엘리먼트 설명
result -  
code string 결과코드 : 0 - 정상
message string 결과가 정상이 아닐 경우 message 출력
list - dsResultCnt
count string  
item -  
field name string CNT [검색건수]
list - dsResult
count string  
item -  
field name string CTRL [제어번호]
field name string DISP01 [서명]
field name string DISP02 [저자]
field name string DISP03 [출판사]
field name string DISP04 [청구기호]
field name string DISP05 []
field name string DISP06 []
field name string DISP07 []
field name string DISP08 []
field name string DISP09 []
field name string LIMT01[]
field name string LIMT05[]
field name string LIMT06[]
field name string ABSYN
field name string AODYN
field name string CONTYN
field name string IMGYN
field name string CONTYN
field name string VODYN
list - dsFacet
count string  
item -  
field name string CODE [패싯 코드]
field name string CODE_NAME [코드명]
field name string COUNT
field name string TYPE [패싯 유형]
list - dsFacet_[dsFacet의 CODE]
count string  
item -  
field name string CODE [패싯 항목 코드]
field name string CODE_COUNT [패싯 항목 카운트]
field name string CODE_NAME [패싯 항목 명]
field name string CODE_VALUE [패싯 항목 값]
field name string ITEM [서브 패싯 항목이 존재할경우 패싯항목 코드]
field name string ITEM_COUNT [서브 패싯 항목이 존재할경우 패싯항목 카운트]
field name string ITEM_NAME [서브 패싯 항목이 존재할경우 패싯항목 명]
field name string NUM [패싯 순서] - 해당 항목이 패싯 제한검색시 조건값으로 들어감
list - dsDispColl(정렬목록)
count string  
item -  
field name string NAME [코드명]
field name string VALUE [코드값]