사이트와 페이지

사이트와 페이지 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_info.site_id, 페이지 식별자는 pages[].page_id 또는 page.page_id, 팝업 식별자는 popups[].popup_id입니다.
• /menus는 pages와 menu_structure를 반환합니다. pages[].page_id로 페이지를 식별하고, 편집기 구성인 menu_structure는 내부 key를 바꾸지 않고 사용합니다.
• 사이트 로고, 색상, 기본 메타는 /site와 /site-meta/{key}에서 먼저 가져옵니다.
• 메뉴를 코드에 고정하지 말고, 화면 진입 시 /menus를 조회하세요.
• 팝업은 화면 진입 시점에 /popups를 조회해서 최신 활성 팝업을 표시하세요.