[알라딘서재]상품API 안내

상품API 안내ｌ상품 API

TTB l 2007-10-15 18:16

http://blog.aladdin.co.kr/ttb/1631069

요청 방법

요청 URL : http://www.aladdin.co.kr/ttb/api/ItemLookUp.aspx
요청 URL샘플 : http://www.aladdin.co.kr/ttb/api/ItemLookUp.aspx?ttbkey=[TTBKey]&itemIdType=ISBN&ItemId=[도서의ISBN]&output=xml
"상품 조회 응답(Reponse) 결과값"의 스펙은 "검색 응답(Reponse) 결과값"과 동일한 결과에 단순히 부가정보가 추가되어지는 것임.
도서의 경우 <bookinfo>, 음반의 경우 <musicinfo>, DVD의 경우 <dvdinfo>의 항목이 추가결과로 나옴. (화장품과 Gift몰상품은 특별한 부가정보 없이 검색결과와 같은 항목만 출력)

상품 조회 요청(Request) 파라미터

구분	요청변수	변수종류	설명
필수	TTBKey	문자열	부여받은 TTBKey값
필수	ItemId	문자열/숫자	상품을 구분짓는 유일한 값 (ItemIdType으로 정수값과 ISBN중에 택일)
옵션 (옵션 조정 변수가 없을 경우에는 기본값으로 조회)	ItemIdType	ISBN(기본값) : ISBN10자리 ISBN13 : ISBN13자리 ItemId	조회용 파라미터인 ItemId가 ISBN으로 입력되었는지, 알라딘고유의"ItemId"값으로 입력되었는지 선택
	Cover	Big : 큰 크기 Mid(기본값) : 중간 크기 Small : 작은 크기 Mini : 매우 작은 크기 None : 없음	표지크기
	Output	XML(기본값) : REST XML형식 OS : 확장RSS(OpenSearch방식) JS : JSON방식	출력방법
	Partner	문자	파트너코드. 제휴사의 경우 파트너코드 입력으로 제휴사 유효성 체크.
	Omitkey	양의정수(기본값:0)	Omitkey가 1인경우 결과링크값에 TTBKey가 제외됨.
	Version	정수형 날짜 (기본값: 20070901)	검색API의 Version(날짜형식)을 설정.
	CallBack	javascript function이름	호출후 불려질 javascript function의 이름을 지정. output이 js인 경우에 한해 작동됨.

상품 조회 응답(Reponse) 결과값 스펙

필드명	설명	자료형
tile	제목	문자열
link	상품페이지 URL 주소	문자열(URL)
pubdate	출간일(출시일)	숫자
author	저자/아티스트	문자열
description	요약 설명구	문자열
isbn	10자리 ISBN	숫자
isbn13	13자리 ISBN	숫자
pricesales	판매가	숫자
pricestandard	정가	판매가
stockstatus	재고상태(정상유통일 경우 비어있음, 품절/절판 등)	문자열
mileage	마일리지	숫자
cover	커버(표지) 이미지(coversum/coveroff/covermini/cover150 등으로 응용가능)	문자열(URL)
CategoryId	카테고리(분류) Id	숫자
CategoryName	카테고리 명칭	문자열
publisher	출판사(제작사/출시사)	문자열
CustomerReviewRank	회원 리뷰 평점(별점 평균) : 0~10점(별0.5개당 1점)	숫자
FullDescription	책소개(일반적인 스펙에는 포함되지 않고, 별도로 요청한 경우에만 협의 후 제공)	문자열
FullDescription2	출판사 제공 책소개(일반적인 스펙에는 포함되지 않고, 별도로 요청한 경우에만 협의 후 제공)	문자열
subTitle	부제	문자열
originalTitle	원제	문자열
itemPage	상품의 쪽수	숫자
toc	목차	문자열
letslookimg	Let's Look(미리보기) 이미지 경로	문자열(URL)
musicinfo < catno	음반 고유의 번호	문자열
musicinfo < recommendationComment	추천글	문자열
dvdinfo < specialFeature	Special Feature	문자열
dvdinfo < disc	Disc장수	숫자
dvdinfo < playtime	상영시간	문자열
dvdinfo < language	언어	문자열
dvdinfo < caption	자막	문자열
dvdinfo < screenrate	화면비율	문자열
dvdinfo < recordingtype	오디오	문자열
dvdinfo < areacode	지역코드	숫자
(musicinfo, dvdinfo) < authors	참여 아티스트들의 이름	문자열
(musicinfo, dvdinfo) < authors < author << authorType	참여아티스트의 역할	문자열(영문)
(musicinfo, dvdinfo) < authors < author << authorid	참여아티스트의 고유번호	숫자
(musicinfo, dvdinfo) < authors < author << desc	authorType에대한 한글 설명	문자열(한글)