스킵네비게이션

본문 바로가기 주메뉴 메인메뉴 국립장애인도서관홈페이지 바로가기

Open API

활용방법

Open API GUIDE

소장자료 검색

사용설명
  • 국립중앙도서관에서 소장하는 도서/비도서 목록정보
요청 URL(request url)
  • http://www.nl.go.kr/app/nl/search/openApi/search.jsp?요청변수=값
요청 변수(request parameter)

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

요청변수 값 설명
No 요청변수 설명
1 key String(필수)

발급키

2 kwd String

검색어

3 pageNum Integer(필수)

현재페이지

4 pageSize Integer(필수)

쪽당출력건수 (기본 10건)

5 category String(필수)

카테고리

단행자료 [dan]

연속자료 [yon]

멀티미디어자료 [media]

장애인자료 [disabled]

웹정보자료 [web]

지도자료 [map]

악보자료 [music]

기타자료 [etc]

해외수집기록물 [archive]

출판예정도서 [cip]

한국고전적종합목록 [korcis]

6 topF1 String(필수)

검색조건1

전체 [total]

제목 [title]

제목(전장일치) [titleRight]

제목(완전일치) [titleFull]

저자 [author]

발행자 [publisher]

청구기호 [cheonggu]

7 sort String

검색조건1

제목 [itltle]

저자 [iauthor]

발행처 [ipublisher]

발행년도 [ipub_year]

청구기호 [cheonggu]

8 desc String

검색조건1

오름차순 [asc]

내림차순 [desc]

9 facetDocYn String

검색조건1

원문있음 [y]

원문없음 [n]

10 detailSearch String

사용 [true]

사용안함 [false]

11 f1 String

전체 [total]

표제/논문명 [title]

키워드 [keyword]

저자 [author]

발행자 [publisher]

12 v1 String

키워드

13 and1 String

AND

OR

NOT

14 f2 String

전체 [total]

표제/논문명 [title]

키워드 [keyword]

저자 [author]

발행자 [publisher]

15 v2 String

키워드

16 and2 String

AND

OR

NOT

17 f3 String

전체 [total]

표제/논문명 [title]

키워드 [keyword]

저자 [author]

발행자 [publisher]

18 v3 String

키워드

19 and3 String

AND

OR

NOT

20 f4 String

전체 [total]

표제/논문명 [title]

키워드 [keyword]

저자 [author]

발행자 [publisher]

21 v4 String

키워드

22 and4 String

AND

OR

NOT

23 isbnOp String

ISBN [isbn]

ISSN [issn]

24 isbnCode String

isbn(issn)코드값

25 guCode3 String

별치기호

26 guCode4 String

분류

27 guCode5 String

도서

28 guCode6 String

권책

29 guCode7 String

한국대학명

30 guCode8 String

한국정부기관명

31 gu10 String

판종유형/판종

32 guCode11 String

CIP제어번호

33 gu12 String

본문언어

34 gu13 String

요약언어

35 gu14 String

요약언어

36 sYear String

발행년도 시작일

37 eYear String

발행년도 시작일

38 gu2 String

분류기호

한국십진분류표(kdc)

한국십진분류표-박봉석편(kdcp)

듀이십진분류표(ddc)

조선총독부 신서부분류표(cec)

조선총독부 양서부분류표(cwc)

조선총독부 고서부분류표(coc)

정부문서분류번호(gpo)

39 guCode2 String

분류코드값

샘플 URL
  • "토지"를 검색할 경우 : http://www.nl.go.kr/app/nl/search/openApi/search.jsp?key=발급된키값&kwd=%ED%86%A0%EC%A7%80&pageSize=10&pageNum=1&category=dan&sort=

※ URL(한글)은 반드시 인코딩해야 함

※ 상세검색은 kwd 값이 없을 경우 상세검색으로 인식합니다. Kwd 값과 상세검색 값은 혼용하여 사용이 불가능 합니다.

상세검색 샘플 URL
  • 제목:"토지", 저자:"박경리" 를 검색할 경우 : http://www.nl.go.kr/app/nl/search/openApi/search.jsp?key=[발급된키값]&category=dan&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 detailLink -

상세페이지경로

25 isbn -

ISBN

26 call_no -

청구기호

27 kdc_code_1s -

동양서분류기호 대분류 코드

28 kdc_name_1s -

동양서분류기호 대분류 명칭

※ 제공서비스에 따라 출력결과 필드는 제한될 수 있습니다.

에러 메시지
에러 메시지
에러코드 설명
000

SYSTEM ERROR : 시스템 오류

010

NO KEY VALUE : 인증키값 누락

011

INVALID KEY : 유효하지 않은 인증키

013

CATEGORY ERROR : 카테고리값 입력오류

014

PARAMETER VALIDATION ERROR : 파라메터 입력값 오류

015

REQUIRED PARAMETER MISSING : 필수 파라메터 입력 오류(검색어 or 상세검색)

101

SEARCH ERROR : 검색서버 오류

퀵메뉴

  • 메일링서비스 신청
  • 협약도서관 안내
  • 사서에게물어보세요
  • 프로그램 다운로드
맨위로
  • 페이지 위로
  • 페이지 아래로