QUICK MENU

Open API

글자크기
인쇄 스크랩

한국고문헌종합목록 검색 Open API 가이드 다운받기

사용설명

국립중앙도서관에서 소장하는 한국고문헌종합목록 목록정보

요청 URL(request url)

https://www.nl.go.kr/NL/search/openApi/searchKorcis.do?요청변수=값

요청 변수(request parameter)

※ 단,검색조건 및 맵핑되는 검색어가 하나이상 포함되어야 함

No,요청변수,형식,설명으로 구성 된 요청 변수(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(필수) 쪽당출력건수
샘플 URL

"김해김씨"를 검색할 경우 : 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(한글)은 반드시 인코딩해야 함


상세페이지 URL

https://www.nl.go.kr/korcis/search/detail.php?rec_key=[REC_KEY]

출력결과 필드의 서지정보 키(REC_KEY)를 사용하여 위와 같이 한국고전적종합목록 상세페이지 URL로 연결



출력결과 필드 (response field)
No,필드,값,설명으로 구성 된 출력결과 필드 (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:유효하지않은 인증키
위로