상품상세정보
본 API는 사용중지가 권고된 상태(Deprecated)이며, 예기치 않은 시점에 API 제공이 중단될 수 있습니다. 만약 본 API의 사용을 새롭게 검토하고 있다면 최신 버전을 선택하십시오. 만약 본 버전의 API를 사용하고 있다면 빠른 시일 내에 사용을 중지하고 최신 버전의 API로 교체하십시오.
API 정보
어떤 상품 1개에 대한 상세한 정보를 조회할 수 있는 API입니다.
Request
순서 | 항목 | 자료형 | 필수 여부 | 설명 |
---|---|---|---|---|
1 | ver | int | Y | api version |
2 | mode | int | Y | api 호출 모드 값 : getItemView |
3 | aid | int | Y | API KEY |
4 | type | int | Y | 도매꾹 : dome , 도매매 : supply |
5 | itemNo | int | Y | 상품번호 |
6 | cache | int | N | 캐쉬 사용 : 1 |
Response
순서 | 항목 | 자료형 | 설명 |
---|---|---|---|
1 | header.itemNo | int | 상품번호 |
2 | sellerInfo.id | string | 판매자 아이디 |
3 | sellerInfo.nick | string | 판매자 닉네임 |
4 | sellerInfo.grade | int | 판매자 등급 |
5 | sellerInfo.type | string | 사업자유형 |
6 | sellerInfo.score.scoreAvg | string | 판매자 점수 |
7 | sellerInfo.score.count | int | 최소판매수량 |
8 | itemInfo.status | string | 상품 판매상태 - 기간미지정 - 승인대기 - 승인거부 - 기간종료 - 판매종료 - 아웃벌점 제재 - 판매중 |
9 | itemInfo.imageArrow | string | 상세이미지 사용여부 (값이 있을 경우 상세이미지 사용가능) |
10 | itemInfo.memoLastUpdate | int | 판매자 메모 최종업데이트 날짜 |
11 | itemInfo.title | int | 상품제목 |
12 | itemInfo.itemOpt | string | 상품주문옵션 PHP Serialized String |
13 | itemInfo.itemOptJson | string | 상품주문옵션 JSON String |
14 | itemInfo.bestItems | string | 베스트 상품 여부 (true or false) |
15 | itemInfo.unitQty | string | 최소 판매수량 |
16 | itemInfo.totalQty | int | 상품재고 |
17 | itemInfo.sampleAllow | int | 샘플판매여부 |
18 | itemInfo.samplePrice | string | 샘플가격 |
19 | itemInfo.sampleQty | string | 샘플판매단위 ※ 2019년 7월 2일 샘플판매단위 기능이 폐지되어, 샘플구매 가능한 상품은 모두 낱개구매가 가능하게 되었습니다. ※ 현재 이 항목은 샘플구매가 가능한 모든 상품에서 1로 표시됩니다. |
20 | itemInfo.price | string | 상품가격 |
21 | itemInfo.setBuy | string | - |
22 | itemInfo.discountPriceBefore | string | 할인전 가격 |
23 | itemInfo.withVat | string | 과세유형 |
24 | itemInfo.size | string | 상품 사이즈 |
25 | itemInfo.weight | string | 상품 무게 |
26 | itemInfo.country | string | 원산지 |
27 | itemInfo.periodDeli | string | 배송기간 |
28 | itemInfo.categoryId | int | 카테고리 아이디 |
29 | itemInfo.idxCOM | string | - |
30 | itemInfo.smallImage | string | 작은 상품 이미지 |
31 | itemInfo.mediumImage | string | 중간 상품 이미지 |
32 | itemInfo.largeImage | string | 큰 상품이미지 |
33 | itemInfo.dateOver | string | 판매종료일 |
34 | itemInfo.receiptMethod | int | - |
35 | itemInfo.itemSection | int | - |
36 | itemInfo.startDate | int | 판매시작일 |
37 | itemInfo.endDate | int | 등록만료일 |
38 | itemInfo.deliveryMethod | int | 배송방법 |
39 | itemInfo.deliveryFee | int | 배송비 |
40 | itemInfo.deliveryFeeType | int | 배송비 지불방법 |
41 | itemInfo.deliveryQtyFeeType | int | 배송비 유형 |
42 | itemInfo.deliBuyerQty | int | fix : 고정배송비 pro : 수량별 비례 qty : 수량별 차등 |
43 | itemInfo.deliBuyerOpts | int | ex) 40+2500|40+2500 수량별 비례일 경우 : 40개까지 2,500원 이후 40개마다 2,500원씩 추가 수량별 차등일 경우 : 1개부터 40개까지는 2,500원 40개 이후부터 2,500원 |
44 | itemInfo.deliveryFeeZone | - | 지역별 추가배송비 정보 (★확장정보) |
45 | itemInfo.deliveryFeeZone.jeju | int | 제주지역 배송시 추가배송비 (★확장정보) |
46 | itemInfo.deliveryFeeZone.islands | int | 도서산간지역 배송시 추가배송비 (★확장정보) |
47 | itemInfo.deliveryFeeZone.useX | string | 추가배송비 사용여부(y/n) |
48 | itemInfo.enableNego | int | 흥정여부 |
49 | itemInfo.infoDutyList.safetyCert.certTitle | string | 안전 인증 제목 |
50 | itemInfo.infoDutyList.safetyCert.type | string | 인증 타입 |
51 | itemInfo.infoDutyList.safetyCert.name | string | 인증 이름 |
52 | itemInfo.infoDutyList.safetyCert.no | string | 안전 인증 번호 |
53 | itemInfo.infoDutyList.safetyCert.certImgUrl | string | 안전 인증 이미지 주소 |
54 | itemInfo.infoDutyList.infoDuty.t | int | 상품고시정보 제목 |
55 | itemInfo.infoDutyList.infoDuty.v | int | 상품고시정보 내용 |
56 | iitemInfo.temMemoList.itemMemo.d | int | 메모날짜 |
57 | itemInfo.itemMemoList.itemMemo.m | int | 메모내용 |
58 | itemInfo.sellerNotice | int | 판매자 공지 |
59 | itemInfo.content | int | 상품상세정보 |
60 | returnAddr | - | 반품 배송지 주소 (판매자가 배송지를 설정하지 않은 경우는 addr이 비어있음) |
61 | returnAddr.no | int | 반품 배송지 출고지번호 (묶음배송 출고지번호와 공유) |
62 | returnAddr.zipcode | string | 반품 배송지 주소 우편번호 |
63 | returnAddr.address1 | string | 반품 배송지 주소1 |
64 | returnAddr.address2 | string | 반품 배송지 주소2 |
65 | returnAddr.phone | string | 반품 배송지 연락처 |
66 | returnAddr.mobile | string | 반품 배송지 휴대폰 번호 |
67 | returnDeliAmt | int | 반품 배송비 |
68 | returnDeliAmtDouble | boolean | 반품 배송비 2배 적용 여부(무료배송 주문시) |
69 | dialog.msg.title | string | 약관 제목 |
70 | dialog.msg.content | string | 약관 내용 |
Response 예시
<?xml version="1.0" encoding="utf-8"?>
<domeggook>
<header>
<itemNo>상품번호</itemNo>
</header>
<sellerInfo>
<id>판매자 아이디</id>
<nick>판매자 닉네임</nick>
<grade>1</grade>
<type></type>
<score>
<scoreAvg>96</scoreAvg>
<count>100</count>
</score>
</sellerInfo>
<itemInfo>
<status>판매중</status>
<imageArrow></imageArrow>
<memoLastUpdate>1421289074</memoLastUpdate>
<title>
<![CDATA[[상품제목]]>
</title>
<sellerPoint>
<type></type>
</sellerPoint>
<itemOpt>
<![CDATA[아이템옵션 serialize 값]]>
</itemOpt>
<bestItems>true</bestItems>
<unitQty>5[more]</unitQty>
<totalQty>93782</totalQty>
<sampleAllow>false</sampleAllow>
<samplePrice>0</samplePrice>
<sampleQty>1</sampleQty>
<price>810</price>
<setBuy>false</setBuy>
<discountPriceBefore></discountPriceBefore>
<withVat>과세상품</withVat>
<size>
<![CDATA[.]]>
</size>
<weight>
<![CDATA[.]]>
</weight>
<country>
<![CDATA[oem]]>
</country>
<periodDeli>0</periodDeli>
<categoryId>01_01_07_02</categoryId>
<idxCOM>0</idxCOM>
<smallImage>http://211.43.195.137/upload/item/2014/01/21/..../....</smallImage>
<mediumImage>http://211.43.195.137/upload/item/2014/01/21/..../....</mediumImage>
<largeImage>http://211.43.195.137/upload/item/2014/01/21/..../....</largeImage>
<dateOver>2015-02-05 23:53:00</dateOver>
<receiptMethod></receiptMethod>
<itemSection>SELL</itemSection>
<startDate>2015-01-31 00:00:00</startDate>
<endDate>2015-02-05 23:53:00</endDate>
<deliveryMethod>택배</deliveryMethod>
<deliveryFee>0</deliveryFee>
<deliveryFeeType>구매자(선불,착불)선택</deliveryFeeType>
<deliveryQtyFeeType>수량별비례</deliveryQtyFeeType>
<deliBuyerQty>pro</deliBuyerQty>
<deliBuyerOpts>50+2500|50+500</deliBuyerOpts>
<enableNego>false</enableNego>
<deliveryFeeZone>
<jeju>5500</jeju>
<doseo>6500</doseo>
<useX>y</useX>
</deliveryFeeZone>
<infoDutyList>
<safetyCert>
<certTitle>
<![CDATA[[생활용품] 공급자적합성확인]]>
</certTitle>
<type>
<![CDATA[생활용품]]>
</type>
<name>
<![CDATA[공급자적합성확인]]>
</name>
<no>
<![CDATA[]]>
</no>
<certImgUrl>
<![CDATA[이미지 주소]]>
</certImgUrl>
</safetyCert>
<infoDuty>
<title>
<![CDATA[반품비용]]>
</title>
<value>
<![CDATA[상세정보 별도표기]]>
</value>
</infoDuty>
<infoDuty>
<title>
<![CDATA[교환.반품.보증/배상금 지급조건]]>
</title>
<value>
<![CDATA[상세정보 별도표기]]>
</value>
</infoDuty>
<infoDuty>
<title>
<![CDATA[피해보상/분쟁처리]]>
</title>
<value>
<![CDATA[상세정보 별도표기]]>
</value>
</infoDuty>
<infoDuty>
<title>
<![CDATA[약관확인]]>
</title>
<value>
<![CDATA[상세정보 별도표기]]>
</value>
</infoDuty>
<infoDuty>
<title>
<![CDATA[종류]]>
</title>
<value>
<![CDATA[상세정보 별도표기]]>
</value>
</infoDuty>
<infoDuty>
<title>
<![CDATA[소재]]>
</title>
<value>
<![CDATA[상세정보 별도표기]]>
</value>
</infoDuty>
<infoDuty>
<title>
<![CDATA[취급시 주의사항]]>
</title>
<value>
<![CDATA[상세정보 별도표기]]>
</value>
</infoDuty>
<infoDuty>
<title>
<![CDATA[품질보증기준]]>
</title>
<value>
<![CDATA[상세정보 별도표기]]>
</value>
</infoDuty>
<infoDuty>
<title>
<![CDATA[A/S책임자와 전화번호]]>
</title>
<value>
<![CDATA[상세정보 별도표기]]>
</value>
</infoDuty>
</infoDutyList>
<itemMemoList>
<itemMemo>
<date>
<![CDATA[]]>
</date>
<memo>
<![CDATA[]]>
</memo>
</itemMemo>
</itemMemoList>
<sellerNotice>
<![CDATA[판매자 공지사항]]>
</sellerNotice>
<content>
<![CDATA[상품상세내용]]>
</content>
<returnAddr>
<no>12345</no>
<zipcode>
<![CDATA[12345]]>
</zipcode>
<address1>
<![CDATA[서울시 영등포구 여의도]]>
</address1>
<address2>
<![CDATA[백상빌딩 5층]]>
</address2>
<phone>
<![CDATA[02-0000-0000]]>
</phone>
<mobile>
<![CDATA[011-0000-0000]]>
</mobile>
</returnAddr>
</itemInfo>
</domeggook>