콘텐츠로 이동
런모아 개발자 문서

런모아API문서

사이트 관리자가 외부 정적 프론트엔드와 판매자 서버를 런모아 데이터와 결제 흐름에 연결할 때 사용하는 문서입니다.
빠른 시작 API 키 이해하기

문서 구조

섹션 제목: “문서 구조”

이 문서는 두 가지 API 표면을 분리해서 설명합니다.

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

권장 시작 순서

섹션 제목: “권장 시작 순서”
  1. API 키 종류에서 브라우저용 키와 서버용 키를 구분합니다.
  2. 빠른 시작의 정적 프론트엔드 흐름을 그대로 구현합니다.
  3. 브라우저 앱은 스토어프론트 API만 호출합니다.
  4. 생성/수정 작업은 서버용 비공개 API에서 서버 키로 처리합니다.
  5. AI 도구나 내부 검색에는 llms.txt, llms-full.txt, openapi.yaml을 사용합니다.

기준 도메인

섹션 제목: “기준 도메인”

문서 예시는 아래 기준으로 작성했습니다.

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

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