책마루 소개

OpenApi 이용안내

  • 책마루 OpenApi는 국립무형유산원 책마루 소장도서 및 발간자료를 타기관에서 편리하게 검색할 수 있는 환경을 제공하는 외부 공개 인터페이스입니다. 책마루 OpenApi 서비스 이용을 희망하는 기관은 책마루 운영 담당자(063 - 280 - 1578)에게 문의하시기 바랍니다.

URL

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

요청변수 (필수)

OpenApi 요청변수, 값, 설명 알림표
요청변수 설명
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

엘리먼트, 값에 관한 설명 알림표
엘리먼트 설명
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 TEM_NAME [서브 패싯 항목이 존재할경우 패싯항목 명]
field name string NUM [패싯 순서] - 해당 항목이 패싯 제한검색시 조건값으로 들어감
list - dsDispColl(정렬목록)
count string
item -
field name string NAME [코드명]
field name string VALUE [코드값]

전라북도 전주시 완산구 서학로95(동서학동 896-1)
대표번호 063·280·1400 팩스번호 063·280·1500