상품리스트
API 정보
주어진 조건에 해당하는 상품들의 목록을 반환하는 API입니다. 본 API를 통해 수신한 상품목록은 동일한 검색조건으로 도매꾹·도매매의 웹서비스에서 검색한 상품목록과 동일합니다. 또한 본 API는 판매중인 상품의 정보만 반환하며, 판매중지·종료·품단종된 상품의 정보는 반환하지 않습니다.
Version
Mode
getItemList
첨부 파일
요청 방식
GET
요청 URL
https://domeggook.com/ssl/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 예시