메인 콘텐츠로 건너뛰기

Headless Commerce

Headless Commerce는 현대적인 이커머스 경험을 구축하기 위한 완전한 REST API를 제공하는 커머스 서비스 플랫폼입니다. 스토어프론트와 백엔드를 분리하고 어떤 프론트엔드 프레임워크로든 자유롭게 개발하세요.

주요 기능

Storefront API

상품 조회, 장바구니 관리, 체크아웃, 주문 추적을 위한 공개 API. Publishable Key로 접근 가능합니다.

Admin API

상품, 재고, 주문, 고객, 할인 등을 관리하는 전체 관리 API. Secret Key가 필요합니다.

웹훅

주문 업데이트, 결제 완료, 재고 변동 등 실시간 이벤트 알림을 제공합니다.

TypeScript SDK

완전한 자동완성을 지원하는 타입 안전 SDK로 원활한 통합이 가능합니다.

아키텍처

API는 두 가지 대상 패턴을 따릅니다:
  • Storefront API (/v1/storefront/*) — 고객 대면 애플리케이션용. Publishable Key(pk_*)로 접근 가능합니다.
  • Admin API (/v1/admin/*) — 백오피스 관리용. Secret Key(sk_*)가 필요합니다.
두 API 모두 동일한 Base URL과 인증 메커니즘을 공유하지만, 범위와 권한이 다릅니다.

시작하기

1

API 키 발급

회원가입 후 대시보드에서 테스트 API 키를 발급받으세요.
2

첫 번째 요청 보내기

Storefront API로 상품 목록을 조회해 보세요.
3

스토어프론트 구축

장바구니, 체크아웃, 주문 관리를 프론트엔드에 통합하세요.