- 국가대체자료종합목록 자료검색
- 국가대체자료종합목록 상세정보
- 참여 도서관 정보
- DeepQA 서비스
국가대체자료 종합목록 OPEN API는 국립장애인도서관의 국가대체자료종합목록을 활용하여 다양한 애플리케이션에 활용할 수 있도록 기술과 서비스를 제공하는 XML 기반의 인터페이스입니다.
국가대체자료종합목록 자료목록
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) |
자료유형
오디오북 : AB 일반도서 : B1 점자도서 : BB 전자점자도서 : BE 점자라벨도서 : BL 전자점자악보 : BS 보이스브레일도서 : BV 묵점자혼용도서 : BW 오디오데이지자료 : DA FULL데이지자료 : DF 텍스트데이지자료 : DT 전자책 : EB TEXT-PDF도서 : EP 큰글자도서 : OL 촉각도서 : OT PDF/UA : TP 소리영화 : VA 화면해설영상자료 : VE 수화영상도서자료 : VS 휴먼음성자료 : WA 디지털음성자료 : WD 쉬운자료 : VD |
| 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은 반드시 인코딩해야 함
에러메시지
화면을 터치한 후에 좌우로 스크롤하세요.
| NO | 에러코드 | 설명 |
|---|---|---|
| 2 | REQUIRED PARAMETER MISSING | 필수정보 없음 |
| 3 | DATA TYPE ERROR | 데이터 형식 오류 |
| 1 | ERROR | 기타 시스템 오류 |