OPEN API
국가대체자료 종합목록 OPEN API는 국립장애인도서관의 국가대체자료종합목록을 활용하여 다양한 애플리케이션에 활용할 수 있도록 기술과 서비스를 제공하는 XML 기반의 인터페이스입니다.
소개
- 국립장애인도서관의 국가대체자료공유시스템에서 소장하는 국가대체자료종합목록 자료의 상세정보를 제공합니다.
국가대체자료종합목록 상세검색
-
요청 URL(Request url)
- https://dream.nld.go.kr/newApp/app/book/cataloginfo?요청변수=값
- 요청 변수(Request parameter)
| NO | 요청변수 | TYPE | 설명 |
|---|---|---|---|
| 1 | return_type | STRING(4) |
결과 유형
xml : XML(기본값) json : JSON |
| 2 | lib_code | STRING(6) | 도서관 부호 |
| 3 | have_control_no | STRING(13) | (필수) 소장제어번호 |
- 출력결과 필드 (Response field)
| NO | 요청변수 | TYPE | 설명 |
|---|---|---|---|
| 1 | controlNo | STRING(12) | 제어번호 |
| 2 | title | STRING(1000) | 자료명 |
| 3 | isbn | STRING(200) | ISBN |
| 4 | creator | STRING(1000) | 저자 |
| 5 | pubDate | STRING(8) | 출판일 |
| 6 | publisher | STRING(500) | 출판사 |
| 7 | producer | STRING(500) | 제작처 |
| 8 | KDC | STRING(10) | 분류기호 |
| 9 | 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 |
| 10 | subject | STRING(2) |
주제
KDC 6판 강목표 앞 2자리 |
| 11 | libCode | STRING(6) | 소장처 도서관 부호 |
| 12 | libName | STRING(100) | 소장처명 |
| 13 | createDate | STRING(20) |
등록일
YYYY-MM-DD HH:MM:SS |
| 14 | have_control_no | STRING(13) | 소장제어번호 |
| 15 | volume | STRING(50) | 권차 |
| 16 | splitnumber | STRING(50) | 분권 |
| 17 | mediaForm | STRING(10) | 매체유형 |
| 18 | bib_edition | STRING(10) | 판정보 |
| 19 | bib_book_page | STRING(10) | 수록면 |
| 20 | language | STRING(10) | 언어 |
| 21 | genre_code | STRING(3) |
장르코드
MYS: 추리/미스터리 HOR: 공포/스릴러 SFS: SF/과학소설 MAT: 무협소설 FAN: 판타지소설 HIS역사소설 ROM: 로맨스소설 COA: 청소년/성장소설 NOR: 일반소설 POE: 시 ETC: 소설외문학 THE: 학술지 SCH: 학술기사 |
| 22 | genre_name | STRING(50) | 장르명 |
| 23 | issn | STRING(100) | issn |
| 24 | abstract | STRING(50) | 초록 |
| 25 | toc | STRING(100) | 목차 |
-
샘플 URL
Example1>검색어 : 도서관부호 ‘011001’, 소장제어번호 '170168717'
http://dream.nld.go.kr/newApp/app/book/cataloginfo?return_type=XML&lib_code=011001&have_control_no=170168717
- 에러메시지
| 번호 | 에러코드 | 설명 |
|---|---|---|
| 1 | REQUIRED PARAMETER MISSING | 필수정보 없음 |
| 2 | DATA TYPE ERROR | 데이터 형식 오류 |
| 3 | ERROR | 기타 시스템 오류 |