서버용 비공개 API 개요

서버용 비공개 API는 판매자 서버, 서버리스 함수, 내부 배치, 직접 curl에서 사용하는 API입니다.

Base URL: https://{site_host}/api/public/v1
Authorization: Bearer {SERVER_PRIVATE_API_KEY}

브라우저에서 호출하지 마세요

서버용 비공개 API 키는 상품/콘텐츠 생성과 수정 권한을 가집니다. 이 키가 브라우저 JavaScript, HTML, 공개 저장소, 모바일 앱 번들에 들어가면 누구나 관리자성 API를 호출할 수 있습니다.

정적 프론트엔드에서 생성/수정 기능이 필요하면 아래 구조를 사용합니다.

브라우저 정적 사이트
  -> 판매자 서버 또는 서버리스 함수
  -> 런모아 서버용 비공개 API

현재 제공 범위

메서드	경로	설명
GET	/product-categories	상품 카테고리 전체 조회
GET	/product-categories/search	상품 카테고리 검색
GET	/products	상품 목록 조회
POST	/products	상품 생성
GET	/products/{productId}	상품 상세 조회
PUT	/products/{productId}	상품 수정
GET	/content-categories	콘텐츠 카테고리 전체 조회
GET	/content-categories/search	콘텐츠 카테고리 검색
GET	/contents	콘텐츠 목록 조회
POST	/contents	콘텐츠 생성
GET	/contents/{contentId}	콘텐츠 상세 조회
PUT	/contents/{contentId}	콘텐츠 수정

공통 헤더

Authorization: Bearer {SERVER_PRIVATE_API_KEY}
Accept: application/json

JSON 요청:

Content-Type: application/json

파일 업로드 또는 이미지 업로드가 포함된 요청:

Content-Type: multipart/form-data

공통 오류

상태 코드	의미
401 Unauthorized	API 키 누락 또는 오류
403 Forbidden	키 권한 부족 또는 사이트 접근 불가
404 Not Found	대상 상품, 콘텐츠, 카테고리를 찾을 수 없음
422 Unprocessable Entity	요청 값 검증 실패

현재 서버용 비공개 API에는 삭제 API를 문서화하지 않습니다. 실제 라우트에 없는 기능을 외부 문서에 먼저 노출하지 않기 위함입니다.