상품리스트
API 정보
주어진 조건에 해당하는 상품들의 목록을 반환하는 API입니다. 본 API를 통해 수신한 상품목록은 동일한 검색조건으로 도매꾹·도매매의 웹서비스에서 검색한 상품목록과 동일합니다. 또한 본 API는 판매중인 상품의 정보만 반환하며, 판매중지·종료·품단종된 상품의 정보는 반환하지 않습니다.
Release Note
* API 이용 유의사항
상품목록 검색을 위하여 아래 검색 조건 중 하나 이상의 파라미터 설정이 필요합니다.
- 기획전번호 (ev), 카테고리 (ca), 아이디(id), 검색어(kw), 상품번호(itemNo)
Request
순서 | 항목 | 자료형 | 필수 여부 | 설명 |
---|---|---|---|---|
1 | ver | string | Y | API Version |
2 | mode | string | Y | API 호출 모드값 : getItemList |
3 | aid | string | Y | API Key |
4 | market | string | Y | 서비스 코드 · dome : 도매꾹 · supply : 도매매 |
5 | om | string | Y | 출력 형식 : json | xml |
6 | sz | int | N | 페이지당 상품 출력개수 · 1 이상 200 이하의 정수를 입력 · 미입력시 20이 기본값 |
7 | pg | int | N | 페이지 번호 |
8 | so | string | N | 검색결과 정렬방식 · se : 정확도순 (검색어 사용시 외에는 사용불가 / 검색어 사용시 기본값) · rd : 도매꾹랭킹순 (검색어 미사용시 기본값) · ha : 인기상품순 · aa : 낮은가격순 · ad : 높은가격순 · sd : 신규판매자순 · qa : 적은판매단위순 · qd : 많은판매단위순 · da : 최근등록순(상품정보등록/수정일 최근순) |
9 | ev | int | N | 기획전 번호 · 특정 기획전에 속한 상품을 검색할 때에만 입력 · market값이 "dome"일 때에만 적용됨 |
10 | ca | string | N | 카테고리 검색 · 2자리의 숫자쌍 5개가 언더 바(_)로 연결된 형태로 입력 ex) 01_01_00_00_00 · 미입력시, 모든 카테고리의 상품을 검색 · 카테고리 값이 잘못 입력된 경우, 미입력한 것으로 간주함 |
11 | id | string | N | 판매자 아이디 검색 |
12 | kw | string | N | 검색어 검색 |
13 | mnp | int | N | 가격대 검색 / 최저가격대 |
14 | mxp | int | N | 가격대 검색 / 최고가격대 ※ mnp에 입력된 값보다 작은 값을 입력한 경우, mxp 값은 미입력한 것으로 간주함 |
15 | mnq | int | N | 최소구매수량 검색 / 최저수량 |
16 | mxq | int | N | 최소구매수량 검색 / 최대수량 ※ mnq에 입력된 값보다 작은 값을 입력한 경우, mxq 값은 미입력한 것으로 간주함 |
17 | who | string | N | 배송비 부담 · S : 무료배송 상품만 검색 · B : 착불 상품만 검색 · P : 배송비 선결제 상품만 검색 · C : 선결제/착불 선택가능 상품만 검색 |
18 | org | string | N | 국산 여부 · kr : 국내산 상품만 검색 · fr : 국외산 상품만 검색 · 이 외의 값이 입력된 경우, 미입력한 것으로 간주함 |
19 | sgd | boolean | N | 우수판매자 상품 검색 · true : 우수판매자 상품만 검색 · false : 전체상품 검색 (기본값) |
20 | fdl | boolean | N | 빠른배송 상품 검색 · true : 빠른배송 상품만 검색 · false : 전체상품 검색 (기본값) |
21 | itemNo | int | N | 상품번호 검색 |
Response
순서 | 항목 | 자료형 | 설명 |
---|---|---|---|
1 | header | - | 검색건수 및 페이지네이션 정보 |
2 | header.numberOfItems | int | 전체 상품의 수 |
3 | header.firstItem | int | 페이지 처음 상품 번호 |
4 | header.lastItem | int | 페이지 마지막 상품 번호 |
5 | header.currentPage | int | 현재 페이지 |
6 | header.itemsPerPage | int | 페이지 당 상품 수 |
7 | header.numberOfPages | int | 전체 페이지 수 |
8 | header.sort | string | 정렬방식 |
9 | _ | int | ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 구 분 선 ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ |
10 | list.item | - | 상품정보 |
11 | list.item.no | int | 상품번호 |
12 | list.item.title | string | 상품제목 |
13 | list.item.price | int | 상품단가 |
14 | list.item.priceOrg | int | 할인 전 단가 ※ 사업자전용상품인 경우에만 표시됨 |
15 | list.item.thumb | string | 상품 썸네일 이미지 URL |
16 | list.item.idxCOM | int | 상품에 사용한 유료등록옵션 · 0 : 포토포커스 · 1 : 프리미엄 · 2 : 우대등록 · 3 : 기본등록 (유료등록옵션 미사용) |
17 | list.item.id | string | 판매자의 아이디 |
18 | list.item.nick | string | 판매자의 닉네임 ※ 닉네임이 없는 경우, 본 요소에 아이디 값이 대체되어 표시됨 |
19 | list.item.unitQty | int | 상품 최소구매수량(MoQ) |
20 | list.item.comOnly | boolean | 사업자전용상품 여부 · true : 사업자회원만 구매가능 · false : 모든 회원이 구매가능 |
21 | list.item.adultOnly | boolean | 성인전용상품 여부 · true : 만 19세 이상인 회원만 구매가능 · false : 모든 회원이 구매가능 |
22 | list.item.lwp | boolean | 최저가확인 상품 여부 · true : 최저가확인 상품 · false : 최저가 확인이 이루어지지 않은 상품 |
23 | list.item.deli | - | 배송 관련 정보 |
24 | list.item.deli.who | string | 배송비 부담 · S : 무료배송 · P : 선결제 · B : 착불 · C : 구매자선택 (착불/선결제) |
25 | list.item.deli.fee | int | 배송비 금액 |
26 | list.item.deli.add | boolean | 구매수량에 따른 배송비 금액의 추가가능 여부 · true : 구매수량이 늘어남에 따라 배송비 금액이 증가하는 상품 · false : 구매수량과 관계없이 배송비 금액이 동일한 상품 ※ 단, 이 값이 false라도 도서산간 지역의 경우에는 추가배송비가 있을 수 있음 |
27 | list.item.deli.fromOversea | boolean | 해외직배송 상품(해외에서 출고되어 배송수령지로 직배송되는 상품)인지 여부 · true : 해외직배송 상품 · false : 해당 없음 |
28 | list.item.url | string | 상품 URL |
29 | list.item.market.domeggook | boolean | 도매꾹 true: 판매중, false: 판매중아님 |
30 | list.item.market.supply | boolean | 도매매 true: 판매중, false: 판매중아님 |
Response 예시
<domeggook>
<header>
<numberOfItems>50858</numberOfItems>
<firstItem>1</firstItem>
<lastItem>2</lastItem>
<currentPage>1</currentPage>
<itemsPerPage>2</itemsPerPage>
<numberOfPages>25429</numberOfPages>
<sort>rd</sort>
</header>
<list>
<item>
<no>7276212</no>
<title><![CDATA[ [르시아] U자형 컬러 바디필로우 3100mm(CN7099) ]]></title>
<thumb><![CDATA[
http://211.43.195.137//upload/item/2017/06/13/149734448280D07EB8C329B5AA19C4F5/149734448280D07EB8C329B5AA19C4F5_stt_330.png
]]></thumb>
<id>cktrader</id>
<price>21200</price>
<unitQty>1</unitQty>
<comOnly>true</comOnly>
<adultOnly>false</adultOnly>
<deli>
<who>P</who>
<fee>2500</fee>
<add>true</add>
<fromOversea>false</fromOversea>
</deli>
<url><![CDATA[ http://domeme.com/s/7276212 ]]></url>
</item>
<item>
<no>7401196</no>
<title><![CDATA[ [하이뷰] 17818/국내제작/메이드쁘띠스카프9종/반다나 ]]></title>
<thumb><![CDATA[
http://211.43.195.137//upload/item/2017/08/18/1503049058AF8BC4E850E292A918D97C/1503049058AF8BC4E850E292A918D97C_stt_330.png
]]></thumb>
<id>trendview</id>
<nick>닉네임</nick>
<price>3770</price>
<unitQty>1</unitQty>
<comOnly>true</comOnly>
<deli>
<who>C</who>
<fee>2500</fee>
<add>false</add>
</deli>
<url><![CDATA[ http://domeme.com/s/7401196 ]]></url>
<market>
<domeggook>true</domeggook>
<supply>true</supply>
</market>
</item>
</list>
</domeggook>