방문 분석 이벤트 수집
브라우저 SDK(`@sayren/storefront-sdk/analytics`)가 페이지뷰·상품 조회·목록 노출·검색·체류 이벤트를 최대 50개씩 보낸다. sendBeacon(`text/plain` 본문의 JSON)과 `application/json`을 모두 받는다. 같은 행동이 여러 번 들어와도 서버가 한 번만 기록하고, 봇·자동화 브라우저는 표시해 집계에서 뺀다. 장바구니·결제·구매는 스토어프론트 API가 서버에서 기록하므로 보내지 않는다.
브라우저 SDK(@sayren/storefront-sdk/analytics)가 페이지뷰·상품 조회·목록 노출·검색·체류 이벤트를 최대 50개씩 보낸다. sendBeacon(text/plain 본문의 JSON)과 application/json을 모두 받는다. 같은 행동이 여러 번 들어와도 서버가 한 번만 기록하고, 봇·자동화 브라우저는 표시해 집계에서 뺀다. 장바구니·결제·구매는 스토어프론트 API가 서버에서 기록하므로 보내지 않는다.
회원 accessToken
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
1 <= length <= 64^[A-Za-z0-9_-]{16,64}$^[A-Za-z0-9_-]{16,64}$1 <= items <= 50Response Body
curl -X POST "https://example.com/storefront/v1/events" \ -H "Content-Type: application/json" \ -d '{ "storeCode": "string", "visitorId": "string", "sessionId": "string", "events": [ { "occurredAt": "2019-08-24T14:15:22Z", "url": "http://example.com", "pageViewId": "string", "name": "page_view" } ] }'결제 요청 (결제창 열기) POST
배송지·결제수단을 확정하고 결제 팝업 진입 URL(`pgParams.popupUrl`)과 첫 결제 시도를 발급한다. PG는 스토어의 결제 설정(사용 중인 PG·우선순위)으로 정해지고 `pgProvider`로 알려 준다. `pgParams`에는 공개 값만 담기며 시크릿은 없다. 스토어프론트는 `popupUrl`만 쓰면 된다. 비회원은 `guest`가 필수다. `testPayment`가 true면 스토어가 테스트 결제(샌드박스) 중이라 실제로 돈이 나가지 않는다 — 결제 화면에 안내를 표시한다. `PAYMENT_NOT_CONFIGURED`·`PAYMENT_PROVIDER_UNAVAILABLE`은 구매자에게 결제 수단 준비 중으로 안내한다.
비회원 주문 조회 POST
다음