OPEN API
소개
- 국립장애인도서관의 국가대체자료공유시스템에서 소장하는 국가대체자료종합목록 자료목록을 제공합니다.
국가대체자료종합목록 자료목록
-
요청 URL(Request url)
- https://dream.nld.go.kr/newApp/app/book/catalogList?요청변수=값
- 요청 변수(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 | 기타 시스템 오류 |