받을 수 있는 쿠폰 목록
지금 받을 수 있는 쿠폰(사용 중, 기간 안, 총 발급 한도가 남음)이다. 최근 만든 순. `productId`를 주면 그 상품이 대상인 쿠폰만 싣는다(대상 상품·카테고리 기준, 최소 주문 금액·즉시할인 중복 조건은 주문서에서 판정한다). 회원 토큰이 있으면 항목마다 `downloaded`(이미 받음)·`downloadable`(더 받을 수 있음)을 싣고, 없으면 둘 다 null이고 `loginRequired`가 true다. 쿠폰을 쓸 수 없는 상점이면 빈 목록이다.
지금 받을 수 있는 쿠폰(사용 중, 기간 안, 총 발급 한도가 남음)이다. 최근 만든 순. productId를 주면 그 상품이 대상인 쿠폰만 싣는다(대상 상품·카테고리 기준, 최소 주문 금액·즉시할인 중복 조건은 주문서에서 판정한다). 회원 토큰이 있으면 항목마다 downloaded(이미 받음)·downloadable(더 받을 수 있음)을 싣고, 없으면 둘 다 null이고 loginRequired가 true다. 쿠폰을 쓸 수 없는 상점이면 빈 목록이다.
회원 accessToken
In: header
Query Parameters
이 상품에 쓸 수 있는 쿠폰만(대상 상품·카테고리 기준). 주문 쿠폰은 제외 대상이 아니면 싣는다
페이지 번호 (1부터, 기본 1)
페이지 크기 (기본 20, 최대 100)
Response Body
application/json
curl -X GET "https://example.com/storefront/v1/coupons"{ "meta": { "status": 200, "code": "OK", "message": "OK", "isSuccess": true }, "data": { "page": 0, "size": 0, "totalElements": 0, "totalPages": 0, "contents": [ { "couponId": "string", "name": "string", "description": "string", "kind": "string", "benefit": { "type": "string", "value": 0, "maxDiscountAmount": 0 }, "minOrderAmount": 0, "stackWithInstantDiscount": true, "target": { "allProducts": true, "includeProductIds": [ "string" ], "includeCategoryIds": [ "string" ], "excludeProductIds": [ "string" ], "excludeCategoryIds": [ "string" ] }, "startsAt": "string", "endsAt": "string", "validDaysAfterIssue": 0, "perMemberIssueLimit": 0, "loginRequired": true, "downloaded": true, "downloadable": true } ] }, "error": null}컬렉션 상품 목록 GET
판매 중인 상품만 상품 검색과 같은 카드로 돌려준다. `sort`를 생략하면 컬렉션의 기본 정렬이고, `manual`은 셀러가 정한 순서다. 조건 자동 컬렉션은 조회할 때마다 조건을 만족하는 상품을 계산하고, 정한 순서가 없어 `manual`은 기본 정렬과 같다. 판매량 상위 조건은 다른 조건을 만족하는 상품 중 기간 판매 수량 상위 N개이고, 판매량순 컬렉션의 `manual`은 판매 수량이 많은 순이다(집계는 최대 10분 늦다).
쿠폰 받기 POST
로그인한 구매자가 다운로드 쿠폰을 받는다. 받은 쿠폰 한 장(내 쿠폰 항목)을 돌려준다. 받은 쿠폰은 내 쿠폰과 주문서의 적용 가능 쿠폰에 뜨고 결제 시작의 `coupons`에 `issueId`로 쓴다. 유효 기간은 받은 시각부터다(받은 뒤 유효 일수가 있으면 그 일수와 쿠폰 종료 시각 중 먼저 끝나는 쪽). 회원당 분당 30회까지다.