책마루 소개
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=[종료위치]
요청변수 (필수)
| 요청변수 | 값 | 설명 |
|---|---|---|
| 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
COPYRIGHT NATIONAL INTAGIBLE HERITAGE CENTER.ALL RIGHTS RESERVED