이 누리집은 대한민국 공식 전자정부 누리집입니다.
신청·참여
활용방법
국가자료종합목록 검색 Open API 가이드 다운받기
사용설명국립중앙도서관에서 소장하는 국가자료종합목록 목록정보
요청 URL(request url)https://www.nl.go.kr/NL/search/openApi/searchKolisNet.do?요청변수=값
요청 변수(request parameter)※ 단,검색조건 및 맵핑되는 검색어가 하나이상 포함되어야 함
| NO | 요청변수 | 형식 | 설명 |
|---|---|---|---|
| 1 | key | String(필수) |
발급키 |
| 2 | srchTarget | String |
total (전체) title (제목), author (저자) publisher (발행자), 생략시 전체 |
| 3 | kwd | String |
검색어 |
| 4 | pageNum | Integer(필수) |
현재페이지 |
| 5 | pageSize | Integer(필수) |
쪽당출력건수 (기본 10건) |
| 6 | sort | String |
[정렬 (생략시 : 정확도순)] ititle (제목) iauthor (저자) ipublisher (발행처), ipub_year (발행년도) cheonggu (청구기호) |
| 7 | desc | String |
asc (오름차순), desc (내림차순) |
"정보"를 검색할 경우 : https://www.nl.go.kr/NL/search/openApi/searchKolisNet.do?key=[발급된키값]&kwd=%EC%A0%95%EB%B3%B4&apiType=xml&searchType=&sort=
※ URL(한글)은 반드시 인코딩해야 함
※ 상세검색은 kwd 값이 없을 경우 상세검색으로 인식합니다. Kwd 값과 상세검색 값은 혼용하여 사용이 불가능 합니다.
상세검색 샘플 URL제목:"토지", 저자:"박경리"를 검색할 경우 : https://www.nl.go.kr/NL/search/openApi/searchKolisNet.do?key=[발급된키값]&kwd=%ED%86%A0%EC%A7%80&detailSearch=true&f1=title&v1=%ED%86%A0%EC%A7%80&f2=author&v2=%EB%B0%95%EA%B2%BD%EB%A6%AC
출력결과 필드 (response field)| NO | 필드 | 값 | 설명 |
|---|---|---|---|
| 1 | kwd | - | 검색어 |
| 2 | category | - | 카테고리 |
| 3 | pageNum | - | 현재페이지 |
| 4 | pageSize | - | 쪽당출력건수 (기본 10건) |
| 5 | sort | - | 정렬 |
| 6 | total | - | 검색건수 |
| 7 | title_info | - | 표제 리스트 |
| 8 | type_name | - | 자료유형 |
| 9 | place_info | - | 자료있는곳명칭 |
| 10 | author_info | - | 저작자 |
| 11 | pub_info | - | 발행자 |
| 12 | menu_name | - | 메뉴명 |
| 13 | media_name | - | 매체구분 |
| 14 | manage_name | - | 자료있는곳 명 |
| 15 | pub_year_info | - | 발행년도사항 |
| 16 | control_no | - | 제어번호 |
| 17 | doc_yn | Y[원문있음] , N[원문없음] | 원문유무 |
| 18 | org_link | - | 원문링크 |
| 19 | id | - | 종키 |
| 20 | type_code | - | 자료유형코드 |
| 21 | lic_yn | - | 저작권유무 |
| 22 | lic_text | - | 저작권설명 |
| 23 | reg_date | - | 비치일 |
| 24 | isbn | - | ISBN |
| 25 | call_no | - | 청구기호 |
| 26 | kdc_code_1s | - | 동양서분류기호 대분류 코드 |
| 27 | kdc_name_1s | - | 동양서분류기호 대분류 명칭 |
※ 제공서비스에 따라 출력결과 필드는 제한될 수 있습니다.
에러메시지| 에러코드 | 설명 |
|---|---|
| 000 | SYSTEM ERROR:SYSTEM 오류 |
| 010 | NO KEY VALUE:인증키값 누락 |
| 011 | INVALID KEY:유효하지않은 인증키 |
| 015 | REQUIRED PARAMETER MISSING:필수 파라메터 입력 오류(검색어 or 상세검색) |
| 101 | SEARCH ERROR:검색서버 오류 |
