쿠폰 받기
로그인한 구매자가 다운로드 쿠폰을 받는다. 받은 쿠폰 한 장(내 쿠폰 항목)을 돌려준다. 받은 쿠폰은 내 쿠폰과 주문서의 적용 가능 쿠폰에 뜨고 결제 시작의 `coupons`에 `issueId`로 쓴다. 유효 기간은 받은 시각부터다(받은 뒤 유효 일수가 있으면 그 일수와 쿠폰 종료 시각 중 먼저 끝나는 쪽). 회원당 분당 30회까지다.
로그인한 구매자가 다운로드 쿠폰을 받는다. 받은 쿠폰 한 장(내 쿠폰 항목)을 돌려준다. 받은 쿠폰은 내 쿠폰과 주문서의 적용 가능 쿠폰에 뜨고 결제 시작의 coupons에 issueId로 쓴다. 유효 기간은 받은 시각부터다(받은 뒤 유효 일수가 있으면 그 일수와 쿠폰 종료 시각 중 먼저 끝나는 쪽). 회원당 분당 30회까지다.
회원 accessToken
In: header
Path Parameters
Response Body
application/json
curl -X POST "https://example.com/storefront/v1/coupons/string/download"{ "meta": { "status": 201, "code": "OK", "message": "OK", "isSuccess": true }, "data": { "issueId": "string", "couponId": "string", "name": "string", "description": "string", "kind": "string", "benefit": { "type": "string", "value": 0, "maxDiscountAmount": 0 }, "minOrderAmount": 0, "status": "string", "validFrom": "string", "validUntil": "string", "usedOrderId": "string", "issuedAt": "string", "source": "string" }, "error": null}받을 수 있는 쿠폰 목록 GET
지금 받을 수 있는 쿠폰(사용 중, 기간 안, 총 발급 한도가 남음)이다. 최근 만든 순. `productId`를 주면 그 상품이 대상인 쿠폰만 싣는다(대상 상품·카테고리 기준, 최소 주문 금액·즉시할인 중복 조건은 주문서에서 판정한다). 회원 토큰이 있으면 항목마다 `downloaded`(이미 받음)·`downloadable`(더 받을 수 있음)을 싣고, 없으면 둘 다 null이고 `loginRequired`가 true다. 쿠폰을 쓸 수 없는 상점이면 빈 목록이다.
방문 분석 이벤트 수집 POST
브라우저 SDK(`@sayren/storefront-sdk/analytics`)가 페이지뷰·상품 조회·목록 노출·검색·체류 이벤트를 최대 50개씩 보낸다. sendBeacon(`text/plain` 본문의 JSON)과 `application/json`을 모두 받는다. 같은 행동이 여러 번 들어와도 서버가 한 번만 기록하고, 봇·자동화 브라우저는 표시해 집계에서 뺀다. 장바구니·결제·구매는 스토어프론트 API가 서버에서 기록하므로 보내지 않는다.