# 런모아 API 문서

> 정적 스토어프론트와 판매자 서버 연동을 위한 한국어 런모아 API 문서입니다. 브라우저용 스토어프론트 API와 서버용 비공개 API를 분리해서 설명합니다.

## 핵심 문서

- [빠른 시작](https://developers.runmoa.com/start/quickstart/): 정적 프론트엔드에서 사이트 정보, 상품 조회, Schoolmoa 로그인, 사용자 API, 결제 시작까지 연결하는 기본 흐름.
- [API 키 종류](https://developers.runmoa.com/start/api-keys/): 브라우저용 `moa_pub_...` 키와 서버용 비공개 API 키의 차이.
- [인증과 로그인](https://developers.runmoa.com/start/authentication/): `X-Runmoa-Site-Key`, 사용자 Bearer 토큰, Schoolmoa callback 처리.

## 스토어프론트 API

- [개요](https://developers.runmoa.com/storefront/overview/): 브라우저용 API 범위와 제외되는 관리자 작업.
- [사이트와 페이지](https://developers.runmoa.com/storefront/site-pages/): `/site`, `/site-meta/{key}`, `/pages`, `/menus`, `/popups`.
- [상품과 콘텐츠 조회](https://developers.runmoa.com/storefront/products-contents/): `/products`, `/contents`, 카테고리, 태그, 리뷰, 보유 상품/콘텐츠 접근 확인.
- [장바구니와 결제 시작](https://developers.runmoa.com/storefront/cart-checkout/): `/guest-cart`, `/cart`, `/orders`, `/payments/initialize`, 쿠폰.
- [주문과 마이페이지](https://developers.runmoa.com/storefront/orders-mypage/): `/me`, `/me/orders`, 배송지, 내 콘텐츠, 멤버십, 결제 카드.
- [게시판](https://developers.runmoa.com/storefront/boards/): `/boards`, `/posts`, `/comments`, 첨부파일.

## 서버용 비공개 API

- [개요](https://developers.runmoa.com/server/overview/): `Authorization: Bearer {SERVER_PRIVATE_API_KEY}`로 호출하는 서버 전용 API.
- [상품 API](https://developers.runmoa.com/server/products/): `/api/public/v1/products` 목록, 상세, 생성, 수정, 태그 연결.
- [콘텐츠 API](https://developers.runmoa.com/server/contents/): `/api/public/v1/contents` 목록, 상세, 생성, 수정, 태그 연결.
- [카테고리 API](https://developers.runmoa.com/server/categories/): 상품/콘텐츠 카테고리 전체 조회와 검색. 스토어프론트 키와 서버용 키 모두 지원.

## 기계 판독 자료

- [OpenAPI YAML](https://developers.runmoa.com/openapi.yaml): API 엔드포인트와 인증 방식.
- [Full LLM context](https://developers.runmoa.com/llms-full.txt): AI 도구에 넣기 쉬운 전체 요약 본문.

## 중요한 규칙

- 브라우저에는 스토어프론트 키만 넣습니다.
- 서버용 비공개 API 키는 브라우저, HTML, 공개 저장소에 넣지 않습니다.
- 상품/콘텐츠 생성과 수정은 서버용 비공개 API에서만 처리합니다.
- 외부 문서에는 내부 라우트명, deprecated 로그인 경로, PG별 내부 결제 경로를 노출하지 않습니다.