스토어프론트 API 개요
구매자용 API 레퍼런스
구매자가 쓰는 멀티테넌트 API입니다. TypeScript에서는 @sayren/storefront-sdk를 씁니다.
베이스 URL과 테넌트 지정
베이스 URL은 https://api.sayren.io/storefront/v1이고 상점은 X-Store-Code 헤더로 지정합니다. 빠뜨리면
404 STORE_NOT_FOUND입니다(상점 지정).
curl https://api.sayren.io/storefront/v1/products -H "X-Store-Code: {상점 코드}"상점 코드는 설정 › 상점 정보의 기본 정보에 있습니다. 상점이 없으면 데모 상점 코드 rk6dzy3b49k0으로
카탈로그를 조회합니다(데모 상점).
- 회원·장바구니·주문·리뷰는 상점 단위로 격리됩니다. 회원 토큰을 다른 상점에 쓰면 401입니다.
- 닫은 상점은 410, 정지된 상점은 503입니다.
인증 체계
| 구매자 | 인증 |
|---|---|
| 회원 | 로그인으로 받은 Access Token(30분)을 Authorization: Bearer로 보냅니다. Refresh Token(14일)은 rotation입니다 |
| 비회원 | 카탈로그는 인증 없음. 장바구니·비회원 주문은 X-Cart-Token 헤더로 익명 세션을 유지합니다 |
| 자체 회원 시스템 | 서버가 회원 토큰을 위임 발급받아 씁니다(구매자 위임) |
같은 Refresh Token을 여러 요청이 동시에 갱신해도 30초 안의 3번까지는 각각 새 쌍을 줍니다. 그 뒤는 401 INVALID_REFRESH_TOKEN입니다.
본인 리소스(주문·클레임·리뷰 등)는 /me 경로로만 접근합니다. 흐름은 구매자 인증에 있습니다.
공통 규칙
- 표준 엔벨로프 —
meta+ 성공data/ 실패error(표준 응답 구조) page·size페이지네이션, 가격은 원 단위 정수- 개인정보는 본인 인증된 요청에만 주고, 남에게 보이는 필드는 가립니다