shop24 문서
멀티테넌트 쇼핑몰 shop24의 API 레퍼런스와 SDK 가이드
shop24는 멀티테넌트 쇼핑몰 플랫폼입니다. 스토어(테넌트) 단위로 상품·주문·정산이 분리되며, 용도가 다른 두 개의 API를 제공합니다.
두 개의 API
| API | 베이스 URL | 대상 |
|---|---|---|
| 관리(Store) API | https://shop.api.avarlabs.com/v1 | 셀러/스토어 운영 (상품·주문·클레임·정산) |
| 스토어프론트 API | https://shop.api.avarlabs.com/storefront/v1 | 구매자 (카탈로그·장바구니·주문·결제) |
- 관리(Store) API — 2단계 토큰:
userToken(계정) 발급 후storeToken(스토어 스코프)으로 교환하며, storeToken이 테넌트를 결정합니다. 요청 경로에 storeId가 필요 없습니다. - 스토어프론트 API — 테넌트는
X-Store-Code헤더로 지정합니다(없으면demo스토어). 카탈로그는 인증 없이 호출할 수 있고, 마이페이지(/me/**)는 회원 Access Token이 필요합니다.
TypeScript 클라이언트가 필요하면 Storefront SDK와 Store SDK를 사용하세요. 모든 요청/응답 타입과 인증 헤더 처리를 제공합니다.