Home>소통·참여>OPEN API

OPEN API

OPEN API 분류탭
국가대체자료 종합목록 OPEN API는 국립장애인도서관의 국가대체자료종합목록을 활용하여 다양한 애플리케이션에 활용할 수 있도록 기술과 서비스를 제공하는 XML 기반의 인터페이스입니다.

소개

  • 국립장애인도서관의 국가대체자료공유시스템에서 소장하는 국가대체자료종합목록 자료목록을 제공합니다.
OPEN API 가이드 다운로드

국가대체자료종합목록 자료목록


  • 요청 URL(Request url)
    • https://dream.nld.go.kr/newApp/app/book/catalogList?요청변수=값
    * 검색어가 한글인 경우, 해당 검색어는 URI 인코딩을 수행해야 함.
  • 요청 변수(Request parameter)
NO 요청변수 TYPE 설명
1 return_type STRING(4) 결과 유형
xml : XML(기본값)
json : JSON
2 search STRING(50) 검색어
3 category STRING(2) 주제 코드
한개만 선택
4 lib_code STRING(30) 자료 소장 도서관 코드
다중선택
스페이스로구분, 전체선택시""
5 data_form STRING(30) 자료 소장 도서관 코드
다중선택
스페이스로구분, 전체선택시""
6 kind NUMBER(1,0) 검색 대상
0:전체(기본값)
1:제목(title)
2:저자(creator)
3:출판사(publisher)
7 orderby NUMBER(1,0) 정렬대상
0: 제목(title)
1: 저자(creator)
2: 출판사(publisher)
3: 출판일(source_date)
4: kdc-십진분류코드
5: 소장처코드(lib_code)
6: 등록일(create_date)
8 sort STRING(4) 정렬방식
asc: 올림차순
desc: 내림차순
9 start NUMBER(2,0) 페이지
(기본값 : 1)
10 limit NUMBER(2,0) 제한 목록 수
(기본값 : 10)
11 genre_code STRING(3) 장르코드
MYS: 추리/미스터리
HOR: 공포/스릴러
SFS: SF/과학소설
MAT: 무협소설
FAN: 판타지소설
HIS역사소설
ROM: 로맨스소설
COA: 청소년/성장소설
NOR: 일반소설
POE: 시
ETC: 소설외문학
THE: 학술지
SCH: 학술기사
12 search_title STRING(100) 상세검색 자료명
13 search_creator STRING(100) 상세검색 저자명
14 search_publisher STRING(100) 상세검색 출판사
15 search_category STRING(4) 상세검색 주제
16 search_data_form STRING(2) 상세검색 자료유형
17 search_lib_code STRING(6) 상세검색 소장처
18 search_control_no STRING(13) 제어번호
  • 출력결과 필드 (Response field)
NO 요청변수 TYPE 설명
1 totalCount NUMBER(6,0) 전체수
2 controlNo STRING(13) 제어번호
3 title STRING(1000) 도서명
4 isbn STRING(200) ISBN
여러 개인 경우 ";"으로 구분
5 creator STRING(1000) 저자
여러 개인 경우 ";"으로 구분
6 producer STRING(500) 제작처
7 prodDate STRING(8) 제작일
8 publisher STRING(500) 출판사
9 pubDate STRING(8) 출판일
10 dataForm STRING(2) 자료유형
일반도서: BK
연속간행물: SB
점자자료: BM
비도서: NB
기타: EX
전자책: EB
녹음자료: N7
기타: N5
컴퓨터파일: N4
시청각자료: N3
학술지: S1
잡지: S2
일반도서: B1
점자도서: BB
점자라벨도서: BL
묵점자혼용도서: BW
전자점자악보: BS
전자점자도서: BE
보이스브레일도서: BV
휴먼음성자료: WA
디지털음성자료: WD
오디오데이지자료: DA
텍스트데이지자료: DT
FULL데이지자료: DF
수화영상도서자료: VS
자막영상자료: VC
화면해설영상자료: VE
소리영화: VA
TEXT전자도서: ET
TEXT-PDF도서: EP
읽기쉬운책: OE
큰글자도서: OL
촉각도서: OT
11 subject STRING(2) 주제
KDC 6판 강목표 앞 2자리
12 libCode STRING(6) 소장처 코드
13 libName STRING(100) 소장 도서관 이름
14 createDate STRING(20) 등록일
YYYY-MM-DD HH:MM:SS
15 have_control_no STRING(13) 소장제어번호
16 volume NUMBER(2,0) 권차
17 splitnumber NUMBER(2,0) 분권
18 publictype STRING(1) 원문서비스공개등급
A: 전체허용
S: 자관허용
D: 국립장애인도서관허용
  • 샘플 URL
    Example1>검색어 : ‘행복’
    http://dream.nld.go.kr/newApp/app/book/catalogList?
    return_type=XML&search=%ED%96%89%EB%B3%B5&category=&lib_code=&data_form=&kind=0&orderby=&sort=&start=1&limit=10
    &genre_code=&search_title=&search_creator=&search_publisher=&search_category=&search_data_form=&search_lib_code=
    &search_control_no=

    Example2>검색어 : 상세검색 저자 ‘조정래’, 상세검색 제목 '한강'
    http://dream.nld.go.kr/newApp/app/book/catalogList?
    return_type=XML&search=&category=&lib_code=&data_form=&kind=0&orderby=&sort=&start=1&limit=10
    &genre_code=&search_title=%ED%95%9C%EA%B0%95&search_creator=%EC%A1%B0%EC%A0%95%EB%9E%98
    &search_publisher=&search_category=&search_data_form=&search_lib_code=&search_control_no=
    • URL은 반드시 인코딩해야 함
  • 에러메시지
번호 에러코드 설명
1 REQUIRED PARAMETER MISSING 필수정보 없음
2 DATA TYPE ERROR 데이터 형식 오류
3 ERROR 기타 시스템 오류