제목뿐만 아니라 저자, 출판사, 카테고리별 검색 등 다양한 옵션이 제공되는 책 검색결과 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 정의되지 않은 오류가 발생하였습니다. |
제목 | 날짜 | ||
---|---|---|---|
671 | [웹로그] SnagIt, Camtasia 무료 배포 | 0 | 2007/12/04 |
670 | [웹 제작] Let's Encrypt 웹호스팅에 적용하기 | 0 | 2015/11/06 |
669 | [윈도우] 속도빠른 VPN으로 불금을 즐겨보자 | 0 | 2016/03/14 |
668 | [리눅스서버] [CentOS] 가비아 서버 사용법 | 0 | 2017/05/06 |
667 | [Nginx] nginx rewrite 룰 | 0 | 2017/05/30 |
666 | [MySQL] MySQL/MariaDB 디비 튜닝하기 | 0 | 2017/06/25 |
665 | [리눅스서버] Nginx 튜닝 | 0 | 2017/06/26 |
664 | [리눅스서버] 계정생성 쉘스크립트 | 0 | 2017/10/03 |
663 | [Nginx] SSL 설정하기 | 0 | 2017/10/15 |
662 | [Nginx] certbot 수동 발급 | 0 | 2017/11/02 |
661 | [Nginx] 리노드 서버 다운그레이드 | 0 | 2017/11/08 |
660 | [웹 제작] 모바일에서 쇼핑몰이나 홈페이지 들어가면 자동적으로 바탕화면에 즐찾 생성 되는 방법 | 0 | 2017/12/02 |