검색창 바로가기 메인콘텐츠 바로가기

메인콘텐츠

OpenAPI

Open API 소개
개발자가 한국교과서연구재단 소장정보, 국립중앙도서관 소장정보, 공공도서관 종합목록 등을 활용하여 다양한 애플리케이션을 보다 쉽게
   개발할 수 있도록 기술과 서비스를 제공하는 인터페이스
XML 프로토콜을 적용하여 다양한 매쉬업 서비스 개발이 용이함
이용절차
회원가입
인증키 발급 신청
한국교과서연구재단 담당자 승인 및 인증키 발급
인증키를 이용한 OpenAPI활용하기
요청 URL (request url)
http://www.kotry.kr/libService/searchOpenApi.do?[요청변수]=[값]
요청변수 (request parameter)

검색조건 및 맵핑되는 검색어가 하나이상 포함되어야 함

URL(한글)은 반드시 인코딩해야 함

상세검색은 kwd 값이 없을 경우 상세검색으로 인식합니다. Kwd 값과 상세검색 값은 혼용하여 사용이 불가능 합니다.

OpenAPI 요청변수
NO 요청변수 설명
1 key String 발급키
2 kwd String 검색어
3 page Integer 페이지
4 perPage Integer 쪽당 출력건수
5 category String 카테고리
국내:kt / 국외:over / 전체:a
6 search_field String 검색조건
total:전체 / title:표제/논문명 / author:저자 / publisher:발행자
8 docyn String 원문유무 (Y/N)
9 sort String 정렬
제목:title / 발행년도:ipub_year
출력결과 필드 (response field)

제공서비스에 따라 출력결과 필드는 제한될 수 있습니다.

OpenAPI 요청변수
NO 경로/필드 설명
1 error_msg 에러메시지
2 kwd 검색어
3 category 카테고리
4 page 현재페이지
5 perPage 쪽당출력건수 (기본 10건)
6 sort 정렬
7 total 검색건수
8 article/id id
9 article/control_no 제어번호
10 article/nation_name 국가명
11 article/type_name 자료유형
12 article/title_info 표제
13 article/author_info 저작자
14 article/pub_info 발행자
15 article/pub_year_info 발행년도사항
16 article/course 교육과정
17 article/grade 학교급
18 article/subject 교과목
19 article/tdc_name 교과서십진분류 강목
20 article/tdc_code 교과서십진분류코드
21 article/isbn ISBN번호
22 article/detail_url 검색 상세서지 페이지 URL
23 article/book_info/manage_name 소장처
24 article/book_info/org_control_no 기관제어번호
25 article/book_info/call_no 청구기호
26 article/book_info/media_type 매체구분
27 article/book_info/docyn 원문유무 (Y/N)
샘플 URL
"토지"를 검색할 경우 :
http://www.kotry.kr/libService/searchOpenApi.do?key=[발급된키값]&kwd=%ED%86%A0%EC%A7%80&perPage=10&page=1&category=kt&sort=&search_field=total
툴팁