본문으로 바로가기

메인콘텐츠

OpenAPI

  • 홈
  • 공공데이터
  • OpenAPI
글씨 크기 확대 축소 인쇄

한국교과서연구재단 OPEN API

Open API 소개
개발자가 한국교과서연구재단 소장정보, 국립중앙도서관 소장정보, 공공도서관 종합목록 등을 활용하여 다양한 애플리케이션을 보다 쉽게
   개발할 수 있도록 기술과 서비스를 제공하는 인터페이스
XML 프로토콜을 적용하여 다양한 매쉬업 서비스 개발이 용이함
이용절차
회원가입
인증키 발급 신청
한국교과서연구재단 담당자 승인 및 인증키 발급
인증키를 이용한 OpenAPI활용하기

교과서 서지정보 검색 API

요청 URL (request url)
http://www.kotry.kr/openapi/search/book.do?[요청변수]=[값]
요청변수 (request parameter)

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

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

교과서 서지정보 검색 API의 요청 변수(순번, 요청변수, 데이터 타입, 설명)
NO 요청변수 데이터 타입 설명
1 key String 발급키
2 pageUnit Integer 1페이지당 검색되는 목록의 크기
3 pageIndex Integer 페이지
4 f1 String 검색조건
title: 제목 / author: 저자 / keyword: 주제 / isbn: ISBN
5 v1 String 검색어
6 edc_crse String 교육과정
2007 개정 교육과정 / 2009 개정 교육과정 / 2011 개정 교육과정 / 미군정/교수요목기 / 제1차 교육과정기 / 제2차 교육과정기 / 제3차 교육과정기 / 제4차 교육과정기 / 제5차 교육과정기 / 제6차 교육과정기 / 제7차 교육과정기
7 divisions String 교과목
총류 / 국어류 / 수학류 / 과학류 / 사회류 / 역사류 / 지리류 / 예체능 / 실업류 / 외국어
8 subdivisions String 강목
수학 / 수학 익힘책 / 실용 및 고급수학 / 산수 / 대수학 / 미적분 확률 및 통계 / 분석학 / 기하학 / 이산수학
9 st_year Number 출판년도 시작 범위
10 ed_year Number 출판년도 종료 범위
11 sort String 정렬
제목:ititle / 발행년도:ipub_year / iauthor: 저자 / ipublisher: 출판사
12 desc String 정렬구분
오름차순:asc / 내림차순:desc
출력결과 필드 (response field)

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

교과서 서지정보 검색 API의 출력결과 필드(순번, 경로/필드, 설명)
NO 경로/필드 설명
1 result 처리결과
2 count 총 카운트
3 page 현재페이지
4/list/item/id고유번호
5/list/item/areaCode지역분류
6/list/item/matName자료형태
7/list/item/title본표제
8/list/item/ititle대표본표제
9/list/item/titleInfo표제사항
10/list/item/author저작자
11/list/item/iauthor대표저작자
12/list/item/authorInfo저작자사항
13/list/item/publisher발행자
14/list/item/ipublisher대표발행자
15/list/item/pubInfo발행자사항
16/list/item/pubYear발행년도
17/list/item/ipubYear대표발행년도
18/list/item/pubYear_info발행년도사항
19/list/item/keyword키워드
20/list/item/edcCrse교육과정
21/list/item/schulGrad학교등급
22/list/item/divisions총류
23/list/item/subdivisions강목
24/list/item/holdInstt소장기관
25/list/item/isbnISBN
26/list/item/controlNo제어번호

공개데이터 OPEN API

요청 URL (request url)
http://www.kotry.kr/openapi/search/openTextBook.do?[요청변수]=[값]
요청변수 (request parameter)

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

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

OpenAPI 요청변수(순번, 요청변수, 데이터 타입, 설명)
NO 요청변수 데이터 타입 설명
1 key String 발급키
2 pageUnit Integer 1페이지당 검색되는 목록의 크기
3 pageIndex Integer 페이지
4 f1 String 검색조건
title: 제목 / author: 저자 / keyword: 주제 / isbn: ISBN
5 v1 String 검색어
6 edcCrse String 교육과정
2007개정교육과정 / 2008개정특수교육과정 / 2009개정교육과정 / 2011개정특수교육과정 / 2015개정교육과정 / 2015개정특수교육과정 / 제6차교육과정 / 제7차교육과정
7 schulGrad String 학교급
고등학교 / 중학교 / 초등학교 / 유치원 / 특수학교
8 publishYearStart Number 발행년도 범위 시작
9 publishYearEnd Number 발행년도 범위 종료
10 schulGrad String 국/검/인정 구분
국정 / 검정 / 인정
11 sort String 정렬
제목:ititle / 발행년도:ipub_year / iauthor: 저자 / ipublisher: 출판사
12 desc String 정렬구분
오름차순:asc / 내림차순:desc
출력결과 필드 (response field)

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

OpenAPI 출력결과 필드(순번, 경로/필드, 설명)
NO 경로/필드 설명
1 result 처리결과
2 count 총 카운트
3 page 현재페이지
4 /list/item/edcCrse 교육과정
5 /list/item/schulGrad 학교급
6 /list/item/schulType 학교유형
7 /list/item/title 서지명
8 /list/item/author 저자
9 /list/item/publisher 출판사
10 /list/item/publishYear 출판년도
11 /list/item/qualType 국/검/인정 구분
12 /list/item/lowVisionZoom 저시력자 지원 구분
13 /list/item/contentNo 콘텐츠번호
툴팁