컬렉션 상품 목록
판매 중인 상품만 상품 검색과 같은 카드로 돌려준다. `sort`를 생략하면 컬렉션의 기본 정렬이고, `manual`은 셀러가 정한 순서다. 조건 자동 컬렉션은 조회할 때마다 조건을 만족하는 상품을 계산하고, 정한 순서가 없어 `manual`은 기본 정렬과 같다. 판매량 상위 조건은 다른 조건을 만족하는 상품 중 기간 판매 수량 상위 N개이고, 판매량순 컬렉션의 `manual`은 판매 수량이 많은 순이다(집계는 최대 10분 늦다).
판매 중인 상품만 상품 검색과 같은 카드로 돌려준다. sort를 생략하면 컬렉션의 기본 정렬이고, manual은 셀러가 정한 순서다. 조건 자동 컬렉션은 조회할 때마다 조건을 만족하는 상품을 계산하고, 정한 순서가 없어 manual은 기본 정렬과 같다. 판매량 상위 조건은 다른 조건을 만족하는 상품 중 기간 판매 수량 상위 N개이고, 판매량순 컬렉션의 manual은 판매 수량이 많은 순이다(집계는 최대 10분 늦다).
회원 accessToken
In: header
Path Parameters
Query Parameters
정렬. 생략하면 컬렉션의 기본 정렬
Value in
- "manual"
- "recommend"
- "latest"
- "priceAsc"
- "priceDesc"
- "reviewCount"
- "ratingDesc"
최소 판매가(즉시할인 반영)
최대 판매가(즉시할인 반영)
페이지 번호 (1부터, 기본 1)
페이지 크기 (기본 20, 최대 60)
Response Body
application/json
curl -X GET "https://example.com/storefront/v1/collections/string/products"{ "meta": { "status": 200, "code": "OK", "message": "OK", "isSuccess": true }, "data": { "page": 0, "size": 0, "totalElements": 0, "totalPages": 0, "contents": [ { "productId": "string", "productNo": null, "name": "string", "thumbnailUrl": "http://example.com", "salePrice": 0, "discountedPrice": 0, "discountRate": 0, "originalPrice": null, "freeShipping": true, "fulfillment": { "type": "string", "requiresShipping": true }, "averageRating": 0, "reviewCount": 0, "soldOut": true } ] }, "error": null}컬렉션 조회 GET
주소(`slug`)로 찾는다. `productSort`는 상품 목록의 기본 정렬이다. 판매량 상위·판매량순 컬렉션은 `productSort`가 `manual`(컬렉션 순서 = 판매량 순)이고 `salesComputedAt`이 판매량 기준 시각이다.
받을 수 있는 쿠폰 목록 GET
지금 받을 수 있는 쿠폰(사용 중, 기간 안, 총 발급 한도가 남음)이다. 최근 만든 순. `productId`를 주면 그 상품이 대상인 쿠폰만 싣는다(대상 상품·카테고리 기준, 최소 주문 금액·즉시할인 중복 조건은 주문서에서 판정한다). 회원 토큰이 있으면 항목마다 `downloaded`(이미 받음)·`downloadable`(더 받을 수 있음)을 싣고, 없으면 둘 다 null이고 `loginRequired`가 true다. 쿠폰을 쓸 수 없는 상점이면 빈 목록이다.