이 누리집은 대한민국 공식 전자정부 누리집입니다.
도서관 서비스
Open API
대한민국 국가서지 검색
담당 부서정보기술기반과(02-590-6312)
사용설명사서지원서비스 대한민국 국가서지를 조회할 수 있는 기능을 제공합니다.
요청 URL(request url)https://librarian.nl.go.kr/LI/search/openApi/seojiSearch.do
요청 변수(request parameter)※단,검색조건 및 맵핑되는 검색어가 하나이상 포함되어야 함
| NO | 요청변수 | 값 | 설명 |
|---|---|---|---|
| 1 | key | String(필수) |
발급키 |
| 2 | kwd | String |
검색어 |
| 3 | pageNum | Integer (필수) |
현재페이지 |
| 4 | pageSize | Integer (필수) |
쪽당출력건수 (기본 10건) |
| 5 | sort | - |
정렬 (생략시 : 정확도순) ititle_asc : 제목(ㄱ~ㅎ순) ititle_desc : 제목(ㅎ~ㄱ순) author_asc : 저자(ㄱ~ㅎ순) author_desc : 저자(ㅎ~ㄱ순) pub_asc : 발행처(ㄱ~ㅎ순) pub_desc : 발행처(ㅎ~ㄱ순) pubyear_asc : 발행년도(과거순) pubyear_desc : 발행년도(최신순) |
| 6 | apiType | String |
xml json |
"토지"를 검색할 경우 : https://librarian.nl.go.kr/LI/search/openApi/seojiSearch.do?key=[발급된키값]&apiType=xml&kwd=%ED%86%A0%EC%A7%80&pageSize=10&pageNum=1&category=&sort=
※ URL(한글)은 반드시 인코딩해야 함
※ 상세검색은 kwd 값이 없을 경우 상세검색으로 인식합니다. Kwd 값과 상세검색 값은 혼용하여 사용이 불가능 합니다.
상세검색 샘플 URL제목:"토지", 저자:"박경리"를 검색할 경우 : https://librarian.nl.go.kr/LI/search/openApi/seojiSearch.do?key=[발급된키값]&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 | String | 검색어 |
| 3 | pageNum | Integer | 현재페이지 |
| 4 | pageSize | Integer | 쪽당출력건수 (기본 10건) |
| 5 | sort | String | 정렬 |
| 6 | total | Integer | 검색건수 |
| 7 | title_info | String | 표제 리스트 |
| 8 | author_info | String | 저작자 |
| 8 | pub_info | String | 발행자 |
| 10 | pub_year_info | String | 발행년도사항 |
| 11 | category | String | 카테고리 |
| 12 | seoji_year | String | 수록연도 |
| 13 | detail_link | String | 상세페이지경로 |
※ 제공서비스에 따라 출력결과 필드는 제한될 수 있습니다. 에러메세지
| 에러코드 | 설명 |
|---|---|
| 000 | SYSTEM ERROR:SYSTEM 오류 |
| 010 | NO KEY VALUE:인증키값 누락 |
| 011 | INVALID KEY:유효하지않은 인증키 |
| 012 | DATA LIMIT 500:검색결과 이동시 500건 제한(500건 이후 데이터 조회불가) |
| 101 | SEARCH ERROR:검색서버 오류 |
