사이트와 페이지

사이트와 페이지 API는 사용자 토큰 없이 호출할 수 있습니다. 모든 요청에는 브라우저용 스토어프론트 키가 필요합니다.

메서드	경로	설명	사용자 토큰
GET	/site	사이트 기본 정보 조회	필요 없음
GET	/site-meta/{key}	사이트 메타 값 조회	필요 없음
GET	/pages/home	홈 페이지 데이터 조회	필요 없음
GET	/pages	페이지 목록 조회	필요 없음
GET	/pages/{slug}	페이지 상세 조회	필요 없음
GET	/menus	메뉴 목록 조회	필요 없음
GET	/popups	활성 팝업 조회	필요 없음

사이트 정보 조회

const site = await fetch(`${API_BASE}/site`, {
  headers: {
    'X-Runmoa-Site-Key': STOREFRONT_KEY,
    Accept: 'application/json',
  },
}).then((response) => response.json());

페이지 상세 조회

const page = await fetch(`${API_BASE}/pages/about`, {
  headers: {
    'X-Runmoa-Site-Key': STOREFRONT_KEY,
    Accept: 'application/json',
  },
}).then((response) => response.json());

구현 팁

• 사이트 로고, 색상, 기본 메타는 /site와 /site-meta/{key}에서 먼저 가져옵니다.
• 정적 사이트 빌드 시점에 메뉴를 고정하지 말고, 런타임에 /menus를 조회하면 관리자 변경 사항을 반영하기 쉽습니다.
• 팝업은 운영자가 자주 바꿀 수 있으므로 /popups 응답을 화면 진입 시점에 조회하는 편이 좋습니다.