화면은 자유롭게,
커머스는 API로
스토어프론트는 React와 TypeScript로 만듭니다. 상품·주문·결제는 sayren API를 부르고, 사이트는 sayren에 배포하거나 직접 호스팅합니다.
$ npx sayren pull
받음 → today-closet (42개)
$ npx sayren deploy
작업 트리 올림 — 3개 파일
버전 v12 빌드 시작
✓ VERIFY 1.2초
✓ TYPECHECK 6.8초
✓ BUILD 14.5초
빌드 성공 — v12
발행 — v12 → https://today-closet.sayren.co
$ npx sayren status
발행 v12 (CLI)
API · SDK
커머스 API는 두 가지입니다.
스토어프론트 API
상품 조회, 장바구니, 주문서, 결제, 구매자 로그인 API를 브라우저에서 호출합니다.
@sayren/storefront-sdk관리 API
상품 등록, 주문 처리, 환불, 쿠폰 API를 서버에서 호출합니다.
@sayren/store-sdk
const sdk = createStorefrontClient({ baseUrl, storeCode });
const products = await sdk.catalog.searchProducts({
keyword: "니트",
});웹훅
주문 이벤트를 외부 시스템으로 보냅니다.
주문, 결제, 배송, 클레임, 재고, 문의 이벤트를 등록한 주소로 보냅니다. 리소스별 순번이 붙어 순서를 맞출 수 있습니다.
| 이벤트 | 순번 | 결과 |
|---|---|---|
ORDER.PAID | sequence 1 | 200 |
ORDER.DISPATCHED | sequence 2 | 200 |
ORDER.DELIVERED | sequence 3 | 200 |
CLAIM.RETURN_REQUESTED | sequence 1 | 재시도 |
호스팅
배포는 두 가지 중에 고릅니다.
sayren 호스팅
서버를 따로 두지 않습니다. 발행하면 HTTPS 주소가 바로 열립니다.
- 미리보기 주소
- 내 도메인
- 버전 관리
- 이전 버전으로 되돌리기
npx sayren pull npx sayren deploy npx sayren status직접 호스팅
스토어프론트 코드를 내려받아 원하는 곳에 배포합니다. API 호출은 같습니다.
- 코드 내려받기
- npm 패키지 사용
- 자체 CI · CDN
결제 복귀 주소를 등록한 도메인으로 제한할 수 있습니다.