요청 방법


  • 요청 URL : http://www.aladin.co.kr/ttb/api/ItemLookUp.aspx
  • 요청 URL샘플 : http://www.aladin.co.kr/ttb/api/ItemLookUp.aspx?ttbkey=TTBKey&itemIdType=ISBN13&ItemId=도서의ISBN&output=xml
  • "상품 조회 응답(Reponse) 결과값"의 스펙은 "검색 응답(Reponse) 결과값"과 동일한 결과에 단순히 부가정보가 추가되어지는 것임.
  • 도서의 경우
  • 분류 ID값은 알라딘 모든 분야 카테고리 엑셀문서를 참고하십시오.(최종 수정일 : 2019.4.25)
  • 보다 상세한 OpenAPI 매뉴얼은 여기를 참고해주세요.


상품 조회 요청(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인 경우에 한해 작동됨.
OptResult c2binfo 중고C2B(알라딘이 고객에게 매입하는 중고) 매입여부 및 매입가 조회.(버전 정보를 Version=20131101로 호출)



상품 조회 응답(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  카테고리 명칭 문자열 
c2bsales 중고 C2B 매입 여부. 1이면 매입가능. 2면 매입불가 상태.(매입 여부는 수시로 변동되는 정보) 숫자 
c2bsales_price 중고 C2B 매입가. AA는 최상급 상태일 경우, A는 상급, B는 중급, C는 균일가매입으로 1천원(C가 0인 경우에는 균일가매입도 불가) 숫자(금액 원)
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에대한 한글 설명 문자열(한글)

 




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