OpenAPI 안내

(최종 수정일 : 2019.4.25)
  • OpenAPI는 (1) 검색API와 (2) 하나의 상품을 열람하는API(이하 상품API) (3) 베스트셀러 등 각종 상품 리스트 API 등 크게 3가지로 나눠집니다.
  • 상품API는 하나의 상품만을 열람하므로 검색API의 결과보다 자세한 부가 정보가 더해진 결과가 나옵니다.
  • 검색API/상품API/리스트API의 결과는 모두 XML형식(기본값), json형식 형식으로 받으실 수 있습니다.
  • 요청방식은 GET방식과 POST방식에 상관없이 요청 가능합니다.
  • OpenAPI는 1일 5,000회로 제한됩니다. 5000회 이상을 원하시는 분은 ttb@aladdin.co.kr으로 연락바랍니다.
  • 분류 ID값은 알라딘 모든 분야 카테고리 엑셀문서를 참고하십시오.
  • 이전버젼(20070901)의 문서는 여기를 참고해주세요.
  • 보다 상세한 OpenAPI 매뉴얼은 여기를 참고해주세요.


상품 리스트 API


제공 리스트 종류
  • 신간 전체 리스트
  • 주목한 만한 신간 리스트
  • 편집자 추천 리스트(카테고리로만 조회 가능 - 국내도서/음반/외서 만 지원)
  • 베스트셀러
  • 북플 베스트셀러(국내도서 만 조회 가능)
요청 방법

리스트 요청(Request) 파라미터 스펙
구분 요청변수 변수종류 설명
필수 TTBKey 문자열 부여받은 TTBKey값
QueryType ItemNewAll : 신간 전체 리스트
ItemNewSpecial : 주목할 만한 신간 리스트
ItemEditorChoice : 편집자 추천 리스트 (카테고리로만 조회 가능 - 국내도서/음반/외서만 지원)
Bestseller : 베스트셀러
BlogBest : 북플 베스트셀러 (국내도서만 조회 가능)
리스트 종류
옵션
(옵션 조정 변수가 없을 경우에는 기본값으로 검색)
SearchTarget Book: 도서
Foreign : 외국도서
Music : 음반
DVD : DVD/블루레이
Used : 온라인 중고샵(도서/음반/DVD 등)
eBook: 전자책
조회 대상 Mall
SubSearchTarget Book : 도서
Music : 음반
DVD : DVD/블루레이
SearchTarget이 중고(Used)인 경우, 서브 Mall 지정
Start 1이상, 양의 정수(기본값:1) 검색결과 시작페이지
MaxResults 1이상 50이하, 양의 정수(기본값:10) 검색결과 한 페이지당 최대 출력 개수
Cover Big : 큰 크기
Mid(기본값) : 중간 크기
Small : 작은 크기
Mini : 매우 작은 크기
None : 없음
표지크기
CategoryId 양의정수 - 분야의 고유 번호(기본값:0, 전체)
(참고 : 알라딘 모든 분야 카테고리)
특정 분야로 리스트 결과를 제한함
Output XML(기본값) : REST XML형식
JS : JSON방식
출력방법
Partner 문자 파트너코드. 제휴사의 경우 파트너코드 입력으로 제휴사 유효성 체크.
includeKey 양의정수(기본값:0) includeKey가 1인 경우 결과의 상품페이지 링크값에 TTBKey가 포함됨.
InputEncoding 문자열(인코딩의 영문이름 - 기본값:utf-8) 검색어의 인코딩 값을 설정. "utf-8"이나 "euc-kr"과 같은 인코딩의 영문이름.
Version 정수형 날짜
(기본값: 20070901)
검색API의 Version(날짜형식)을 설정.
(최신버젼: 20131101)
OptResult 문자(Array) - 추가로 받아올 정보 선택
ebookList : 해당 종이책의 전자책 정보
usedList : 해당 상품에 등록된 중고상품 정보
fileFormatList : 전자책의 포맷 및 용량
* 요청시 OptResult=ebookList,usedList와 같은 형태로 요청







댓글(0) 먼댓글(0) 좋아요(3)
좋아요
북마크하기찜하기