런모아API문서

API 구분

런모아 외부 연동 API는 두 가지로 나뉩니다.

구분	사용 위치	인증 방식	대표 기능
스토어프론트 API	브라우저, 정적 HTML/React 앱, 외부 프론트엔드	X-Runmoa-Site-Key + 필요 시 사용자 토큰	사이트 정보, 상품/콘텐츠/카테고리/태그 조회, 로그인, 장바구니, 주문, 결제 초기화, 마이페이지
서버용 비공개 API	판매자 서버, 서버리스 함수, 직접 curl	Authorization: Bearer {SERVER_PRIVATE_API_KEY}	상품/콘텐츠 생성, 수정, 카테고리 조회, 태그 연결

시작 순서

1. API 키 종류에서 브라우저용 키와 서버용 키를 구분합니다.
2. 빠른 시작의 정적 프론트엔드 흐름을 그대로 구현합니다.
3. AI 도구로 storefront를 만들 때는 AI 스토어프론트 빌드 가이드를 함께 사용합니다.
4. 브라우저 앱은 스토어프론트 API만 호출합니다.
5. 생성/수정 작업은 서버용 비공개 API에서 서버 키로 처리합니다.
6. AI 도구에는 llms.txt, llms-full.txt, openapi.yaml을 사용합니다.
7. 연동 도움이나 추가 API 요청은 문의하기를 사용합니다.

Base URL

API 호출에는 아래 Base URL을 사용합니다.

스토어프론트 API: https://{site_host}/api/storefront/v1
서버용 비공개 API: https://{site_host}/api/public/v1

{site_host}에는 런모아에서 운영되는 판매자 사이트 호스트를 넣습니다.