카테고리 API

카테고리 조회는 스토어프론트 키와 서버용 비공개 키에서 모두 사용할 수 있습니다. 정적 프론트엔드는 /api/storefront/v1 경로와 X-Runmoa-Site-Key를 사용하고, 판매자 서버는 /api/public/v1 경로와 서버용 비공개 키를 사용합니다.

X-Runmoa-Site-Key: {STOREFRONT_KEY}
Accept: application/json

Authorization: Bearer {SERVER_PRIVATE_API_KEY}
Accept: application/json

상품 카테고리 전체 조회

GET /api/public/v1/product-categories
GET /api/storefront/v1/product-categories

Query parameters

이름	필수	타입	설명
lang	선택	integer	1: ko, 2: en, 3: ja. 기본값 1

curl -X GET "https://{site_host}/api/public/v1/product-categories?lang=1" \
  -H "Authorization: Bearer {SERVER_PRIVATE_API_KEY}" \
  -H "Accept: application/json"

상품 카테고리 검색

GET /api/public/v1/product-categories/search
GET /api/storefront/v1/product-categories/search

Query parameters

이름	필수	타입	설명
query	필수	string	검색 키워드
lang	선택	integer	1: ko, 2: en, 3: ja. 기본값 1

검색 결과에는 매칭된 카테고리와 해당 카테고리의 하위 카테고리가 포함됩니다.

curl -X GET "https://{site_host}/api/public/v1/product-categories/search?query=후디&lang=1" \
  -H "Authorization: Bearer {SERVER_PRIVATE_API_KEY}" \
  -H "Accept: application/json"

콘텐츠 카테고리 전체 조회

GET /api/public/v1/content-categories
GET /api/storefront/v1/content-categories

Query parameters

이름	필수	타입	설명
lang	선택	integer	1: ko, 2: en, 3: ja. 기본값 1

curl -X GET "https://{site_host}/api/public/v1/content-categories?lang=1" \
  -H "Authorization: Bearer {SERVER_PRIVATE_API_KEY}" \
  -H "Accept: application/json"

콘텐츠 카테고리 검색

GET /api/public/v1/content-categories/search
GET /api/storefront/v1/content-categories/search

Query parameters

이름	필수	타입	설명
query	필수	string	검색 키워드
lang	선택	integer	1: ko, 2: en, 3: ja. 기본값 1

curl -X GET "https://{site_host}/api/public/v1/content-categories/search?query=포토샵&lang=1" \
  -H "Authorization: Bearer {SERVER_PRIVATE_API_KEY}" \
  -H "Accept: application/json"

대표 응답 필드

필드	설명
category_id	카테고리 ID
parent_category_id	부모 카테고리 ID
name	카테고리명
description	카테고리 설명
path	상위 카테고리를 포함한 표시 경로
children	하위 카테고리 목록