sayren Docs
컬렉션

컬렉션 상품 목록

판매 중인 상품만 상품 검색과 같은 카드로 돌려준다. `sort`를 생략하면 컬렉션의 기본 정렬이고, `manual`은 셀러가 정한 순서다. 조건 자동 컬렉션은 조회할 때마다 조건을 만족하는 상품을 계산하고, 정한 순서가 없어 `manual`은 기본 정렬과 같다. 판매량 상위 조건은 다른 조건을 만족하는 상품 중 기간 판매 수량 상위 N개이고, 판매량순 컬렉션의 `manual`은 판매 수량이 많은 순이다(집계는 최대 10분 늦다).

GET
/storefront/v1/collections/{slug}/products

판매 중인 상품만 상품 검색과 같은 카드로 돌려준다. sort를 생략하면 컬렉션의 기본 정렬이고, manual은 셀러가 정한 순서다. 조건 자동 컬렉션은 조회할 때마다 조건을 만족하는 상품을 계산하고, 정한 순서가 없어 manual은 기본 정렬과 같다. 판매량 상위 조건은 다른 조건을 만족하는 상품 중 기간 판매 수량 상위 N개이고, 판매량순 컬렉션의 manual은 판매 수량이 많은 순이다(집계는 최대 10분 늦다).

AuthorizationBearer <token>

회원 accessToken

In: header

Path Parameters

slug*string

Query Parameters

sort?string

정렬. 생략하면 컬렉션의 기본 정렬

Value in

  • "manual"
  • "recommend"
  • "latest"
  • "priceAsc"
  • "priceDesc"
  • "reviewCount"
  • "ratingDesc"
minPrice?string

최소 판매가(즉시할인 반영)

maxPrice?string

최대 판매가(즉시할인 반영)

page?string

페이지 번호 (1부터, 기본 1)

size?string

페이지 크기 (기본 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}