제목뿐만 아니라 저자, 출판사, 카테고리별 검색 등 다양한 옵션이 제공되는 책 검색결과 API를 이용해 나만의 도서관을 만들어 보세요.
요청 변수 | 값 | 설명 | ||
key | string (필수) | 이용 등록을 통해 받은 key 스트링을 입력합니다. | ||
target | string (필수) : book | 서비스를 위해서는 무조건 지정해야 합니다. | ||
query | string (필수) | 검색을 원하는 질의, UTF-8 인코딩 입니다. | ||
display | integer : 기본값 10, 최대 100 | 검색결과 출력건수를 지정합니다. 최대 100 까지 가능합니다. | ||
start | integer : 기본값 1, 최대 1000 | 검색의 시작위치를 지정할 수 있습니다. 최대 1000 까지 가능합니다. | ||
필드 | 값 | 설명 | ||
rss | - | 디버그를 쉽게 하고 RSS 리더기만으로 이용할 수 있게 하기 위해 만든 RSS 포맷의 컨테이너이며 그 외의 특별한 의미는 없습니다. | ||
channel | - | 검색 결과를 포함하는 컨테이너입니다. 이 안에 있는 title, link, description 등의 항목은 참고용으로 무시해도 무방합니다. | ||
lastBuildDate | datetime | 검색 결과를 생성한 시간입니다. | ||
total | integer | 검색 결과 문서의 총 개수를 의미합니다. | ||
start | integer | 검색 결과 문서 중, 문서의 시작점을 의미합니다. | ||
display | integer | 검색된 검색 결과의 개수입니다. | ||
item | - | 개별 검색 결과이며, title, link, description을 포함합니다. | ||
title | string | 검색 결과 문서의 제목을 나타냅니다. 제목에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. | ||
link | string | 검색 결과 문서의 하이퍼텍스트 link를 나타냅니다. | ||
image | string | 썸네일 이미지의 URL입니다. 이미지가 있는 경우만 나타납니다. | ||
author | string | 저자정보입니다. | ||
price | integer | 정가 정보입니다. 절판도서 등으로 가격이 없으면 나타나지 않습니다. | ||
discount | integer | 할인 가격정보입니다. 절판도서 등으로 가격이 없으면 나타나지 않습니다. | ||
publisher | string | 출판사 정보입니다. | ||
pubdate | date | 출간일 정보입니다. | ||
isbn | integer | ISBN 넘버입니다. | ||
description | string | 검색 결과 문서의 내용을 요약한 패시지 정보입니다. 문서 전체의 내용은 link 를 따라가면, 읽을 수 있습니다. 패시지에서 검색어와 일치하는 부분은 <b> 태그로 감싸져 있습니다. | ||
000 : System error 시스템 에러 |
010 : Your query request count is over the limit
쿼리요청 제한을 초과하였습니다. 일반적으로는 5,000개이상의 쿼리에 대하여 이 에러 메세지가 발생되나, 쿼리 제한이 다르게 설정된 경우에는 이에 준하여 발생됩니다. |
011 : Incorrect query request
잘 못된 쿼리요청입니다. 쿼리(query=)필드 자체가 없는 경우 발생하는 에러 메세지 입니다. ...&query=& 식으로 입력하는 경우 정상적인 쿼리 요청으로 보고, 에러 메세지를 발생하지 않으며, "에 대한 검색을 수행합니다. |
020 : Unregistered key
등록되지 않은 키입니다. |
021 : Your key is temporary unavailable
사용할 수 없는 키입니다. OpenAPI에 등록되었으나, 일시적으로 사용 중지된 키를 통하여 쿼리를 검색하는 경우 발생하는 에러입니다. |
100 : Invalid target value
부적절한 target 값입니다. 필드 설명에 없는 target이름을 사용한 경우, 혹은 target필드가 없는 경우 발생하는 메세지입니다. |
101 : Invalid display value
부 적절한 display 값입니다. display필드 자체가 없는 경우에는 정상적인 쿼리 요청으로 보고 에러메세지를 발생하지 않으며, 기본값인 display=10으로 처리됩니다. display값이 100을 초과하는 경우나 0이하의 값일때, 혹은 '...&display=&'와 같이 값을 입력하지 않은 경우에는 에러 메세지를 발생합니다. |
102 : Invalid start value
부 적절한 start 값입니다. start필드 자체가 없는 경우에는 정상적인 쿼리 요청으로 보고 에러메세지를 발생하지 않으며, 기본값인 start=1으로 처리됩니다. start값이 1000을 초과하거나 0이하의 경우, 혹은 '...&start=&'와 같이 값을 입력하지 않은 경우에는 에러 메세지를 발생합니다. |
110 : Undefined sort value
정 의되지 않은 sort값입니다. sort필드 자체가 없는 경우는 정상적인 쿼리 요청으로 보고 에러메세지를 발생하지 않으며, sort 옵션을 사용하는 서비스 API인 경우 기본값인 sort=sim으로 처리됩니다. sort값이 해당하는 서비스의 정렬옵션 이외의 값을 가지는 경우 혹은 '...&sort=&'와 같이 값을 입력하지 않은 경우 에러 메세지를 발생합니다. ( 예, 지식iN 검색 쿼리 요청에서 쇼핑 검색의 정렬 옵션인 sort=asc를 사용하는 경우 ) |
200 : Reserved |
900 : Undefined error occured 정의되지 않은 오류가 발생하였습니다. |
제목 | 날짜 | ||
---|---|---|---|
191 | [GitHub] github.io 페이지 만들기 | 157 | 2015/09/04 |
190 | [윈도우] .sit 파일 압축 풀기 | 1124 | 2015/09/06 |
189 | [윈도우] hiberfil | 160 | 2015/09/10 |
188 | [기타] pc에서 인스타 하기 | 420 | 2015/09/14 |
187 | [기타] 인스타그램 pc버전 인스타넷 | 1316 | 2015/09/14 |
186 | [윈도우] 윈도우 8.1 0x80070011 오류 | 458 | 2015/09/21 |
185 | [윈도우] .net Framework 3.5(닷넷프레임워크)이 깔리지 않을 때(0x80071a90)[Windows 8.1] | 1202 | 2015/09/22 |
184 | [Apm] [bitnami] 맥에서 APM 사용하기(비트나미 설치) | 289 | 2015/09/22 |
183 | [브라우저] 브라우저 중복 즐겨찾기 정리 프로그램 | 135 | 2015/10/06 |
182 | [웹 제작] Let's Encrypt 웹호스팅에 적용하기 | 0 | 2015/11/06 |
181 | [Apm] AutoSet(오토셋) vs ApmSetup7 | 294 | 2015/11/17 |
180 | [Apm] WT-NMP - portable Nginx Mysql Php development stack for Windows | 142 | 2015/11/17 |