스토어프론트 API 개요

스토어프론트 API는 외부 정적 프론트엔드가 런모아 사이트 기능을 사용할 수 있도록 만든 브라우저용 API입니다.

Base URL: https://{site_host}/api/storefront/v1
Site key: X-Runmoa-Site-Key: moa_pub_xxxxxxxxx

공통 헤더

X-Runmoa-Site-Key: moa_pub_xxxxxxxxx
Accept: application/json

사용자 인증이 필요한 API에는 아래 헤더를 추가합니다.

Authorization: Bearer USER_LOGIN_TOKEN

기능 범위

범위	설명
사이트/페이지	사이트 기본 정보, 메타, 페이지, 메뉴, 팝업
상품/콘텐츠 조회	상품/콘텐츠 목록과 상세, 카테고리, 태그, 콘텐츠 요약/설명
로그인	Schoolmoa client id 조회, callback 처리, 로그아웃
장바구니	게스트 장바구니, 로그인 장바구니, 게스트 장바구니 병합
주문/결제	주문 생성, 결제 초기화, 내 주문 조회
마이페이지	내 정보, 보유 콘텐츠, 멤버십, 배송지, 포인트/캐시
게시판	게시판, 게시글, 댓글, 첨부파일

스토어프론트 API에서 제외되는 기능

아래 작업은 브라우저용 키로 제공하지 않습니다.

• 상품 생성, 수정, 삭제
• 콘텐츠 생성, 수정, 삭제
• 관리자 설정 변경
• 판매자 정산, 매출, 리포트, 내부 운영 데이터 조회

해당 작업은 서버용 비공개 API 또는 관리자 전용 기능에서 처리해야 합니다.

결제 경로 원칙

문서와 외부 사이트에는 PG별 내부 경로를 노출하지 않습니다.

외부 정적 프론트엔드는 항상 아래 경로로 결제를 시작합니다.

POST /api/storefront/v1/payments/initialize

런모아 서버가 사이트 결제 설정을 기준으로 실제 PG 흐름을 처리합니다.