신청·참여
Open API
한국고문헌종합목록 검색 Open API 가이드 다운받기
사용설명국립중앙도서관에서 소장하는 한국고문헌종합목록 목록정보
요청 URL(request url)https://www.nl.go.kr/NL/search/openApi/searchKorcis.do?요청변수=값
요청 변수(request parameter)※ 단,검색조건 및 맵핑되는 검색어가 하나이상 포함되어야 함
NO | 요청변수 | 형식 | 설명 |
---|---|---|---|
1 | key | String(필수) | 발급키 |
2 | page | Integer(필수) | 페이지 |
3 | search_field1 | String(필수) - 기본값 : total_field | 검색조건1 |
4 | value1 | String(필수) | 검색어1 |
5 | and_or_not1 | String : AND/OR/NOT | 검색어 연결조건1 |
6 | search_field2 | String | 검색조건2 |
7 | value2 | String | 검색어2 |
8 | and_or_not2 | String : AND/OR/NOT | 검색어 연결조건2 |
9 | search_field3 | String | 검색조건3 |
10 | value3 | String | 검색어3 |
11 | and_or_not3 | String : AND/OR/NOT | 검색어 연결조건3 |
12 | search_field4 | String | 검색조건4 |
13 | value4 | String | 검색어4 |
14 | and_or_not4 | String : AND/OR/NOT | 검색어 연결조건4 |
15 | search_field5 | String | 검색조건5 |
16 | value5 | String | 검색어5 |
17 | gubun1 | String | 표준부호 |
18 | code1 | String | 표준부호 값 |
19 | gubun2 | String | 분류기호 |
20 | code2 | String | 분류기호 값 |
21 | start_year | Integer | 발행년도 시작 |
22 | end_year | Integer | 발행년도 끝 |
23 | maxCount | String | 최대검색건수 |
24 | sort_ksj | String | 정렬조건 |
25 | hanja_trans | String (null / Y) | 한자한글변환 |
26 | per_page | Integer(필수) | 쪽당출력건수 |
"김해김씨"를 검색할 경우 : https://www.nl.go.kr/NL/search/openApi/searchKorcis.do?key=[발급된키값]&page=1&search_field1=total_field
&and_or_not1=NOT&value1=%EA%B9%80%ED%95%B4%EA%B9%80%EC%94%A8&maxCount=1000&per_page=10
※ URL(한글)은 반드시 인코딩해야 함
https://www.nl.go.kr/korcis/search/detail.php?rec_key=[REC_KEY]
출력결과 필드의 서지정보 키(REC_KEY)를 사용하여 위와 같이 한국고전적종합목록 상세페이지 URL로 연결
출력결과 필드 (response field)
NO | 필드 | 값 | 설명 |
---|---|---|---|
1 | METADATA | 루트 엘리먼트 | |
2 | TOTAL | 검색건수 | |
3 | RECORD | 검색 결과 컨테이너(레코드 수만큼 반복) | |
4 | NUMBER | Integer | 출력리스트 번호 |
5 | TITLE | String | 서명 |
6 | AUTHOR | String | 저자 |
7 | PUBLISHER | String | 발행자 |
8 | PUBYEAR | String | 발행년도 |
9 | TYPE | String | 자료유형 |
10 | CONTENTS | String | 목차유부 |
11 | LIB_NAME | String | 도서관명 |
12 | LIB_CODE | String | 도서관부호 |
13 | REC_KEY | Integer | 서지정보 키 |
※ 제공서비스에 따라 출력결과 필드는 제한될 수 있습니다.
에러메시지
에러코드 | 설명 |
---|---|
000 | SYSTEM ERROR:SYSTEM 오류 |
010 | NO KEY VALUE:인증키값 누락 |
011 | INVALID KEY:유효하지않은 인증키 |