전시매장

전시 매장 API는 매장 번호(storeNo), 카테고리 번호(categoryNo), 브랜드 번호(brandNo)를 기준으로, Front 화면에 매장 상세 정보를 구성하기 위한 정보를 제공합니다. 매장의 기본 구성은 매장 정보, 템플릿 정보, 코너 목록으로 이루어져 있습니다. 카테고리 매장의 경우 카테고리 정보가 추가로 제공되며, 브랜드 매장의 경우 브랜드 정보가 추가로 제공됩니다. 전시 템플릿은 하나만 조회되며, 없을 경우 매장 정보 조회가 정상적으로 이루어지지 않습니다.

주요 기능

매장 정보 조회
- 비정형 매장, 브랜드 매장, 카테고리 매장이 조회될 수 있습니다.
- 기본 구성은 전시 매장, 전시 템플릿, 전시 코너 목록입니다.
브랜드 매장 조회
- 기본 구성에 브랜드 정보가 추가로 조회됩니다.
카테고리 매장 조회
- 기본 구성에 카테고리 정보가 추가로 조회됩니다.
- 전시 템플릿이 없을 경우 기본 카테고리 전시 템플릿이 조회됩니다.
전시 템플릿 노출
- 전시 기간에 따라 유동적으로 전시 템플릿이 노출됩니다.
전시 코너 목록 노출
- 전시 여부, 전시 기간, 전시 매체에 따라 유동적으로 전시 코너 목록이 노출됩니다.
캐싱 적용
- 매장 정보, 템플릿 정보, 코너 목록에 대한 캐싱을 적용하여 데이터 트래픽을 최소화합니다.
상품 목록 제공
- 카테고리에서 판매량이 높은 상품 목록 정보를 제공합니다.
19세 미만 회원 처리
- 19세 미만 회원에게 특정 상품(유해 매체 및 유해 약물)을 법령에 맞추어 노출합니다.

프로세스 정의

번호	업무명	설명

번호	업무명	설명
1	매장정보 조회	매장번호를 통해 비정형/카테고리/브랜드 매장 정보 조회가 가능합니다. 카테고리나 브랜드 매장일 경우 해당 카테고리/브랜드를 조회합니다.
2	카테고리 매장정보 조회	카테고리 매장에 세팅된 매장, 템플릿, 카테고리, 코너, 콘텐츠를 조회합니다. 연결된 템플릿이 없을 경우 매장, 기본 템플릿, 카테고리 정보만 조회합니다.
3	브랜드 매장정보 조회	브랜드 매장에 세팅된 매장, 템플릿, 브랜드, 코너, 콘텐츠를 조회합니다.
4	카테고리 베스트 상품 조회(더미)	카테고리 베스트 상품을 조회하는 코너가 매장 템플릿에 연결되어 있을 경우 호출됩니다. 더미 코너 API로 코너가 추가됨에 따라 가변적으로 호출 될 수 있습니다.
5	브랜드 매장 목록 조회	전시 중인 브랜드 매장정보 목록을 조회합니다.

API 기능 목록

API	설명	Server	메소드	비고

API	설명	Server	메소드	비고
매장정보 조회	매장번호, 전시매체코드로 상세 매장정보를 조회합니다. 매장은 BO 전시연결관리에서 템플릿과 코너에 등록된 컨텐츠 내용이 제공됩니다.	Display	GET	🔗API 확인하기> 상품 브랜드 목록 조회: /api/goods/v1/brands/list 상품 리뷰 목록 조회: /api/goods/v1/review/getReviewDetailList
브랜드 매장 목록 조회	전시 중인 브랜드 매장정보 목록을 조회합니다. BO 전시연결관리에 브랜드 매장에 등록된 매장정보를 제공합니다.	Display	GET	🔗API 확인하기>
브랜드 매장정보 조회	브랜드번호, 전시매체코드로 상세 브랜드 매장정보를 조회합니다.	Display	GET	🔗API 확인하기> 상품 브랜드 목록 조회: /api/goods/v1/brands/list 상품 리뷰 목록 조회: /api/goods/v1/review/getReviewDetailList
카테고리 매장정보 조회	카테고리번호, 전시매체코드로 상세 카테고리 매장정보를 조회합니다. 카테고리 매장에 전시 가능한 매장템플릿이 없을 경우 기본 카테고리 템플릿 정보가 전달됩니다.	Display	GET	🔗API 확인하기> 상품 브랜드 목록 조회: /api/goods/v1/brands/list 상품 리뷰 목록 조회: /api/goods/v1/review/getReviewDetailList
카테고리 베스트상품 조회	카테고리 상품을 판매순으로 정렬하여 조회합니다. 더미코너 (샘플)	Display	GET	🔗API 확인하기>

용어 정의

명칭	설명	비고

명칭	설명	비고
전시매장	비정형 매장, 브랜드 매장, 카테고리 매장으로 나뉘며 템플릿 및 코너가 연결될 수 있는 단위를 의미합니다.
전시템플릿	전시매장 페이지 레이아웃을 영역별 또는 상품이 전시되는 형태로 정의한 파일을 의미합니다. 전시템플릿이 전시매장에 연결되면 코너를 매핑하여 콘텐츠의 전시 노출 관리를 할 수 있습니다.
전시코너	전시템플릿의 특정 영역에 상품, 이미지, 텍스트, HTML 등의 전시대상을 노출 관리하는 단위를 의미합니다. 전시코너는 세트로 구성되며, Default로 1개의 세트가 존재합니다.
전시연결	템플릿 및 코너를 기반으로 이미지, HTML, 동영상등의 내용을 추가하여여 Front 전시영역에 정보를 제공하는 기본개념입니다.

기타 참고사항

전시코너가 미노출 될 경우 전시코너의 전시여부, 전시기간, 전시매체 확인이 필요합니다.
전시코너에 콘텐츠는 제한 없이 등록할 수 있습니다.
다만, API 호출 시 콘텐츠 최대 노출 수에 맞춰 조회됩니다.
전시코너 콘텐츠가 미노출 될 경우 콘텐츠의 전시여부, 전시기간, 전시순서 확인이 필요합니다.
브랜드매장의경우브랜드관리에등록된브랜드정보가노출되지않고, 전시연결관리에에등록된브랜드매장정보가Front에노출됩니다