OPEN API

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

소개

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

https://dream.nld.go.kr/newApp/app/book/
catalogList?요청변수=값
* 검색어가 한글인 경우, 해당 검색어는 URI 인코딩을 수행해야 함.

화면을 터치한 후에 좌우로 스크롤 하세요.

국가대체자료 종합목록의 자료목록을 불러오기위한 API 호출 요청변수를 담은 표. 번호, 요청변수,타입, 설명이 적혀있다.
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)	제어번호

화면을 터치한 후에 좌우로 스크롤 하세요.

국가대체자료 종합목록의 자료목록을 불러오기위한 API 호출 요청변수를 담은 표. 번호, 요청변수,타입, 설명이 적혀있다.
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)	제어번호

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_categor
y=&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&g
enre_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은 반드시 인코딩해야 함

화면을 터치한 후에 좌우로 스크롤 하세요.