이 누리집은 대한민국 공식 전자정부 누리집입니다.
도서관 서비스
Open API
사서추천도서 Open API 가이드 다운받기
담당 부서정보기술기반과(02-590-0727)
사용설명국립중앙도서관 사서추천도서
요청 URL(request url)https://nl.go.kr/NL/search/openApi/saseoApi.do?요청변수=값
요청 변수(request parameter)| NO | 요청변수 | 형식 | 설명 |
|---|---|---|---|
| 1 | key | String(필수) |
발급키 |
| 2 | startRowNumApi | integer |
시작번호(1부터시작) |
| 3 | endRowNemApi | integer |
종료번호 |
| 4 | start_date | integer |
검색시작일 |
| 5 | end_date | integer |
검색종료일 |
| 6 | drCode | integer |
분류번호(11:문학, 6:인문과학, 5:사회과학, 4:자연과학) |
https://nl.go.kr/NL/search/openApi/saseoApi.do?key=[발급된 인증키]&startRowNumApi=1&endRowNumApi=10&start_date=20200101&end_date=20200131&drcode=11
출력결과 필드 (response field)| NO | 필드 | 값 | 설명 |
|---|---|---|---|
| 1 | totalCount | Integer | 해당분류 총 개수 |
| 2 | recom_no | Integer | 추천번호 |
| 3 | recom_code | Integer | 분류번호 |
| 4 | decode | String | 분류명 |
| 5 | recom_title | String | 추천도서 제목 |
| 6 | recom_author | String | 추천도서 작가 |
| 7 | recom_publisher | String | 추천도서 자료출판사 |
| 8 | recom_callno | String | 추천도서 청구기호 |
| 9 | recom_file_path | String | 추천도서 이미지 경로 |
| 10 | recom_mokcha | String | 추천도서 목차 |
| 11 | recom_contents | String | 추천도서 자료내용 |
| 12 | recom_reg_dt | String | 추천도서 등록일 |
| 13 | control_no | String | 추천도서 제어번호 |
| 14 | publish_year | Integer | 추천도서 발행년도 |
| 15 | recom_year | Integer | 추천도서 추천년도 |
| 16 | recom_month | Integer | 추천도서 추천월 |
| 17 | mokchFilePath | String | 목차 이미지 경로 |
| 18 | recome_isbn | String | 추천도서 ISBN |
※ 제공서비스에 따라 출력결과 필드는 제한될 수 있습니다.
출력결과 필드 - 검색 결과가 없을경우(response field)| NO | 필드 | 값 | 설명 |
|---|---|---|---|
| 1 | totalCount | Integer | 해당 deCode의 총갯수만 나옴 |
| 에러코드 | 설명 |
|---|---|
| 010 | NO KEY VALUE:인증키값 누락 |
| 011 | INVALID KEY:유효하지않은 인증키 |
