상품리스트
본 API는 사용중지가 권고된 상태(Deprecated)이며, 예기치 않은 시점에 API 제공이 중단될 수 있습니다. 만약 본 API의 사용을 새롭게 검토하고 있다면 최신 버전을 선택하십시오. 만약 본 버전의 API를 사용하고 있다면 빠른 시일 내에 사용을 중지하고 최신 버전의 API로 교체하십시오.
API 정보
주어진 조건에 해당하는 상품들의 목록을 반환하는 API입니다. 본 API를 통해 수신한 상품목록은 동일한 검색조건으로 도매꾹·도매매의 웹서비스에서 검색한 상품목록과 동일합니다. 또한 본 API는 판매중인 상품의 정보만 반환하며, 판매중지·종료·품단종된 상품의 정보는 반환하지 않습니다.
Request
순서 | 항목 | 자료형 | 필수 여부 | 설명 |
---|---|---|---|---|
1 | ver | int | Y | api version : 1.0 |
2 | mode | int | Y | api 호출 모드 값 : getItemList |
3 | aid | int | Y | API KEY |
4 | cache | int | N | 캐쉬 사용 : 1 |
5 | pg | int | N | 페이지 번호 |
6 | so | string | N | 최근등록순 : da 인기상품순 : ha 낮은가격순 : aa 높은가격순 : ad 신규판매자순 : sd 적은판매단위순 : qa 많은판매단위순 : qd 도매꾹랭킹순 : rd 정확도순 : se 주문옵션사용순 : oa |
7 | type | int | Y | 도매꾹 : dome, 도매매 : supply |
8 | sw | int | N | 검색어 (sf 값 필요) |
9 | sf | int | N | 아이디 검색 : id 닉네임 검색 : nick 상품검색 : itemTitle 상품번호 : mother |
10 | oe | int | N | 출력 인코딩 설정 utf-8, euc-kr |
11 | om | int | N | 출력모드 xml json srz |
12 | ic | int | N | 상품출력갯수 : 20 (기본갯수) |
13 | mem_id | int | N | 상품검색을 할 경우 상품검색을 하는 사용자의 ID (구매자 로그인 ID) |
14 | cat | int | N | 카테고리 번호 (ex : 01_00_00_00) |
15 | iopt | int | N | 상품주문옵션 사용여부 사용 : 1 미사용 : 0 미입력 : 전체 |
Response
순서 | 항목 | 자료형 | 설명 |
---|---|---|---|
1 | header.numberOfItems | int | 총 상품 개수 |
2 | header.currentPage | int | 현재 페이지 번호 |
3 | header.firstItem | int | 시작 상품 번호 |
4 | header.lastItem | int | 마지막 상품 번호 |
5 | header.itemsPerPage | int | 현재 페이지에 출력되는 상품 개수 |
6 | header.numberOfPages | int | 페이지의 총 개수 |
7 | header.sort | string | 정렬방식 (검색조건의 so 파라메터 항목 참조) |
8 | items.title | string | 상품제목 |
9 | items.idxCOM | int | - |
10 | items.itemNo | int | 상품번호 |
11 | items.useOption | int | 상품옵션 사용여부 (1 : 사용, 0 : 미사용) |
12 | items.addPrice | int | 상품옵션가 추가금액 사용여부 (1 : 사용, 0: 미사용) ※ useOption이 1일때만 항목이 표시됨 |
13 | items.useOptImgSrc | int | 상품옵션 표시이미지 |
14 | items.domeDiscountPriceBefore | int | 상품 할인전 가격 |
15 | items.price | int | 상품가격 |
16 | items.id | string | 판매자 아이디 |
17 | items.nick | string | 판매자 닉네임 |
18 | items.sellerLv | int | 판매자 등급 |
19 | items.setBuy | string | 판매대행 여부 |
20 | items.withVat | string | 부가가치세 여부 |
21 | items.dateAdvOver | int | 상품유료옵션기간 종료일 |
22 | items.dateAdvStart | int | 상품유료옵션기간 시작일 |
23 | items.categoryId | string | 카테고리 아이디 |
24 | items.categoryName | string | 카테고리명 (소속카테고리도 표시됨) |
25 | items.unitQty | int | 판매수량 단위 |
26 | items.optionPaidPG | string | - |
27 | items.soleSales | int | 단독판매 여부 (1 : 단독판매, 0 : 해당없음) |
28 | items.smallImage | string | 작은 사이즈 이미지 |
29 | items.smallImagePng | string | 작은 사이지 이미지 png |
30 | items.mediumImage | string | 중간 사이즈 이미지 |
31 | items.mediumImagePng | string | 중간 사이지 이미지 png |
32 | items.onlyForAdult | int | 미성년자 구배불가 상품(성인용품) 여부 (1 : 성인용품, 0 : 일반상품) |
33 | items.sellMarket | string | json_encode domeggook, supply 각 값이 1: 판매중, 0: 판매중아님 |
34 | items.sellMarketWithNotOpen | string | 판매중여부 상관없이 도매꾹/도매매에 등록한 상품인지 여부확인 json_encode domeggook, supply 각 값이 1: 등록함, 0: 등록하지 않음 |
35 | items.options.sampleQty | int | [도매매 - type값이 supply 의 경우 노출] 샘플구매 최소 수량 |
36 | items.options.sampleTotalAmt | int | [도매매 - type값이 supply 의 경우 노출] 상품샘플가격 |
37 | items.options.recomAmt0 | int | [도매매 - type값이 supply 의 경우 노출] 추천판매준수가격 |
38 | items.options.recomAmt1 | int | [도매매 - type값이 supply 의 경우 노출] 추천판매준수가격 |
39 | items.options.supplyDiscountPriceBefore | int | [도매매 - type값이 supply 의 경우 노출] 도매매 상품 할인전 가격 |
40 | items.options.supplyAmt | int | [도매매 - type값이 supply 의 경우 노출] 공급단가 |
41 | items.options.supplyQty | int | [도매매 - type값이 supply 의 경우 노출] 공급개수 |
42 | items.options.supplyTotalAmt | int | [도매매 - type값이 supply 의 경우 노출] 상품공급가격 |
Response 예시
<?xml version="1.0" encoding="utf-8"?>
<domeggook>
<header>
<numberOfItems>181502</numberOfItems>
<currentPage>1</currentPage>
<firstItem>1</firstItem>
<lastItem>20</lastItem>
<itemsPerPage></itemsPerPage>
<numberOfPages>9076</numberOfPages>
<sort>sd</sort>
</header>
<items>
<title>
<![CDATA[[상품제목]]>
</title>
<idxCOM>0</idxCOM>
<itemNo>0000000</itemNo>
<useOption>1</useOption>
<addPrice>1</addPrice>
<useOptImgSrc>
<![CDATA[http://211.43.195.137/image/v6/elements/item/list/img_iconItemOption.png]]>
</useOptImgSrc>
<domeDiscountPriceBefore></domeDiscountPriceBefore>
<price>810</price>
<id>
<![CDATA[판매자 아이디]]>
</id>
<nick>
<![CDATA[판매자 닉네임]]>
</nick>
<sellerLv>1</sellerLv>
<setBuy>false</setBuy>
<withVat>false</withVat>
<dateAdvOver>1423147980</dateAdvOver>
<dateAdvStart>1422630000</dateAdvStart>
<categoryId></categoryId>
<categoryName></categoryName>
<unitQty>5</unitQty>
<optionPaidPG></optionPaidPG>
<lowestPrice>0</lowestPrice>
<soleSales>0</soleSales>
<smallImage>http://211.43.195.137/upload/item/2014/01/21/..../....</smallImage>
<smallImagePng>http://211.43.195.137/upload/item/2014/01/21/..../....</smallImagePng>
<mediumImage>http://211.43.195.137/upload/item/2014/01/21/..../....</mediumImage>
<mediumImagePng>http://211.43.195.137/upload/item/2014/01/21/..../....</mediumImagePng>
<onlyForAdult>0</onlyForAdult>
<sellMarket>{"domeggook":1,"supply":0}</sellMarket>
<options>
<sampleQty>1</sampleQty>
<sampleTotalAmt>9900</sampleTotalAmt>
<recomAmt0>7920</recomAmt0>
<recomAmt1>9900</recomAmt1>
<supplyDiscountPriceBefore></supplyDiscountPriceBefore>
<supplyAmt>6500</supplyAmt>
<supplyQty>1</supplyQty>
<supplyTotalAmt>6500</supplyTotalAmt>
</options>
</items>
...
</domeggook>