추천 도서

인터파크도서에 제공하는 신간도서 Open API 입니다. 인터파크 도서에 등록되는 상품을 각 분야로 집계하여 제공됩니다.

1. 요청 URL (request url)

http://book.interpark.com/api/recommend.api

2-1. 요청 변수 (request parameter)

요청 변수	값	설명
key	string (필수)	이용 등록을 통해 받은 인증키를 입력합니다.
categoryId	분야의 고유 번호(필수)	지정한 카테고리의 베스트 셀러를 검색합니다.

요청 변수

값

설명

key

string (필수)

이용 등록을 통해 받은 인증키를 입력합니다.

categoryId

분야의 고유 번호(필수)

지정한 카테고리의 베스트 셀러를 검색합니다.

샘플 URL

국내도서 전체의 신간도서 보기

http://book.interpark.com/api/recommend.api?key=interpark&categoryId=100

2-2. 상세 검색-요청 변수 (request parameter)

※ 상세 검색은 검색 필수 사항을 보자 세부적으로 설정하여 검색할 수 있도록 합니다.

요청 변수	변수 옵션	설명
output	xml(기본값) : REST XML형식 json : JSON방식	검색 결과의 출력 방식을 설정합니다.
callback	javascript function이름	호출후 불려질 javascript function의 이름을 지정합니다. * output이 json인 경우에 한해 작동됩니다.

샘플 URL

결과값을 XML로 출력하기
http://book.interpark.com/api/recommend.api?key=interpark&categoryId=100&output=xml

3. 출력 결과 필드 (response field)

요청 변수	값	설명
title	문자열	검색 결과 페이지의 제목을 표시함니다.
link	문자열(URL)	검색 결과를 확인 할 수 있는 페이지 주소(URL)을 표시합니다.
imageUrl	문자열(URL)	제공자의 이미지 주소(URL)을 표시합니다.
language	문자열	겸색 결과의 언어를 표시합니다.
copyright	문자열	API 제공자의 Copyright를 표시합니다.
pubDate	날짜	검색 결과를 생성한 시간을 표시합니다.. (GMT 기준시)
totalResults	숫자	총 검색 결과의 개 수를 표시합니다.
startIndex	숫자	현재의 페이지 번호를 표시합니다.
itemsPerPage	숫자	한 페이지당 표시되는 검색 결과 개수를 표시합니다.
maxResults	숫자	검색을 요청한 페이지당 결과 개수를 표시합니다.
query	문자열	검색을 요청한 쿼리(검색어)를 표시합니다.
searchCategoryId	숫자	검색 결과를 요청한 카테고리의 아이디값을 표시합니다.
searchCategoryName	문자열	검색 결과를 요청한 카테고리의 이름을 표시합니다.
returnCode	숫자	오류메시지의 코드를 표시합니다.
returnMessage	문자열	오류메시지를 표시합니다.
item < itemId	숫자	검색 상품의 고유번호를 표시합니다.(상품번호)
item < title	문자열	검색 상품의 이름을 표시함니다.
item < isbn	문자열	검색 상품의 ISBN을 표시합니다.
item < url	문자열(URL)	검색 상품의 주소(URL)을 표시합니다. ※ '고맙습니다' 적립 : 주소에 "&key=인증키"를 추가하여야 합니다.
item < author	문자열	검색 상품의 저자(음악일 경우 가수, DVD일 경우 감독)를 표시합니다.
item < translator	문자열	검색 상품의 역자(DVD일 경우 배우)를 표시합니다.
item < description	문자열	검색 상품의 설명을 표시합니다. (HTML 제외)
item < priceStandard	숫자(통화)	검색 상품의 정가를 표시합니다.
item < priceSales	숫자(통화)	검생 상품의 판매가를 표시합니다. (수시로 변동 될 수 있습니다.)
item < discountRate	숫자	검색 상품의 할인율을 표시합니다. (단위 %)
item < saleStatus	문자열	검색 상품의 판매 상태를 표시합니다.
item < mileage	숫자(통화)	검색 상품의 상품 구매시 지급되는 마일리지를 표시합니다.
item < mileageRate	숫자	검색 상품의 상품 구매시 지급되는 마일리지율을 표시합니다.(단위 %)
item < coverSmallUrl	문자열(URL)	검색 상품의 작은 사이즈 이미지를 표시합니다.
item < coverLargeUrl	문자열(URL)	검색 상품의 큰 사이즈 아미지를 표시합니다.
item < categoryId	숫자	검색 상품이 속한 카테고리의 아이디값을 표시합니다.
item < categoryName	문자열	검색 상품이 속한 카테고리의 이름을 표시합니다.
item < publisher	문자열	검색 상품의 출판사(제작사)를 표시합니다.
item < pubDate	문자열	검색 상품의 출간일(등록일)을 표시합니다.

4. 비고/에러 메시지

에러코드	에러 메시지
000	정상
001	시스템 에러
101	등록되지 않은 키입니다.
102	사용할 수 없는 키입니다. OpenAPI에 등록되었으나, 일시적으로 사용 중지된 키를 통하여 쿼리를 검색하는 경우 발생하는 에러입니다.
201	authKey 파라미터가 없습니다.
202	query 파라미터가 없습니다.
203	categoryId 파라미터가 없습니다.
301	부적절한 queryType값입니다.
302	부적절한 searchTarget 값입니다.
303	부적절한 start 값입니다.
304	부적절한 maxResults 값입니다.
305	부적절한 adultImageExposure 값입니다.
306	부적절한 query 값입니다. queryType이 productNumber일 경우 숫자로 설정해야 합니다.
307	정의되지 않은 sort값입니다.
308	정의되지 않은 categoryId 값입니다.
309	정의되지 않은 output 값입니다.
310	정의되지 않은 inputEncoding 값입니다.
311	정의되지 않은 soldOut 값입니다.
400	1일접속제한을 초과하였습니다.
401	정보가 존재하지 않습니다.