상품 리스트
쇼핑몰에서 판매하는 상품의 리스트를 전시하는 화면입니다.
🅐 전시 카테고리
쇼핑몰 어드민에 매핑된 상품 카테고리를 출력하는 영역입니다. 상위 depth의 카테고리의 경우 해당 카테고리 하위 카테고리에 매핑된 전체 상품을 출력합니다.
아래 어드민 경로에서 설정하실 수 있습니다.
► 전시 카테고리 조회 쇼핑몰의 모든 카테고리 정보를 조회합니다.
쇼핑몰 화면에서 카테고리란, 화면이 바뀌어도 대부분의 경우 화면에 상시 노출되는 요소입니다.
아래 2가지 형태의 카테고리 데이터를 제공합니다.
flatCategories : 모든 카테고리를 하나의 배열에 쭉 나열한 형태
multiLevelCategories : 계층을 가지는 카테고리 형태 (최대 5depth)
기본 스킨에서는 multiLevelCategories를 사용하고 있습니다. 따라서 카테고리는 아래와 같이 계층 구조로 구성되며, 최대 5depth까지 어드민에서 카테고리를 추가할 수 있습니다.
🅑 상품 리스트 조회 영역
아래 GET /products/search 호출을 통해 리턴 값으로 받은 상품 리스트를 노출하는 영역입니다.
► 상품 검색하기 다양한 검색 옵션에 맞는 상품 리스트를 조회합니다.
선택 값인 파라미터(Parameters)에 어떤 값을 입력하느냐에 따라 카테고리, 정렬, 검색 등 다양한 조건의 상품 리스트를 가져올 수 있습니다.
GET /categories/{categoryNo}/display-setting
► 전시카테고리 진열 설정 조회
전시카테고리번호(categoryNo)에 해당하는 전시카테고리의 진열 설정을 조회합니다. API 응답으로 전달된 진열 방식을 기준으로 화면의 정렬 여부와 상품 조회 API의 정렬 조건(
order.by)을 결정합니다.
기본 스킨에서는 전시카테고리의 진열 방식이 '자동 진열' 인 경우에만 정렬 조건 선택 영역이 노출되며, '수동 진열' 인 경우에는 노출되지 않습니다.
㉠ 정렬 조건 order.by
1. 자동 정렬
운영자가 별도로 노출 순서를 설정하지 않은 경우 기본으로 적용되는 정렬 방식입니다.
아래 정렬 조건은 order.by 의 자동 정렬 조건이며, 운영자가 원하는 정렬 조건을 호출하여
상품 리스트를 노출할 수 있습니다.
자동 정렬 조건
✅판매량순 (POPULAR) : 주문 건 수 기준
✅낮은/높은 가격순 (DISCOUNTED_PRICE) : 할인 적용가 기준
✅상품 후기순 (REVIEW) : 상품 후기 갯수 기준
✅신상품순 (RECENT_PRODUCT) : 상품 등록일 기준
판매일자(SALE_YMD), 판매종료일자(SALE_END_YMD : 판매시작/종료일 기준
좋아요순 (LIKE_CNT) : 좋아요 갯수 기준
유효일자순 (EXPIRATION_DATE) : 상품 유효일자 기준
인기순(POPULAR) : 판매가 및 인기도 기준 점수 산정 기준 보기 >
✅ 표시된 항목은 개별형 스킨에 기본으로 출력되는 정렬조건
2. 수동 정렬
운영자가 어드민에서 직접 설정한 상품 노출 순서를 그대로 프론트에 반영하는 정렬 방식입니다.
order.by 파라미터의 DISPLAY_CATEGORY_ORDER 값을 호출하면,
서비스어드민의 전시관리 > 전시카테고리 진열 관리 메뉴에서 설정한 상품 순서(상단 고정 포함)대로
상품 리스트가 출력됩니다.
📌 TIP 어드민에서의 상품 노출 순서 조정
전시카테고리 진열 관리(수동 진열)에서 운영자는 카테고리별 상품 노출 순서를 직접 조정할 수 있습니다.
순서 변경 : 상품을 체크한 뒤
최상단 / 위로 / 아래로 / 최하단버튼 또는N번째로 이동입력으로 노출 순서를 조정합니다.상단 고정 : 특정 상품을 카테고리 최상단에 고정 노출할 수 있습니다. (상단 고정 → 일반 진열 순서 순으로 노출)
㉡ 카테고리 categoryNos
전달된 전시카테고리 번호를 기준으로 해당 전시카테고리 내의 상품을 검색합니다.
㉢ 키워드 검색 filter.keywords
키워드 검색창(search engine)에 입력하여 검색 시, 기본 스킨에서는 '{검색어} 검색결과 N개' 라고 안내문구가 출력되며, 검색된 결과가 없는 경우 '검색 결과가 없습니다.' 라고 상품 리스트 출력 영역에 안내 문구가 노출됩니다.
🅒 좋아요 버튼
상품 리스트 화면에서 기본 스킨의 상품 리스트 조회 영역은 메인 상품진열 영역의 디스플레이 유형 중 '갤러리형'으로 제공됩니다. 따라서 좋아요 버튼이 제공되며, 장바구니 버튼은 제공되지 않습니다.
좋아요 기능은 쇼핑몰 회원(member)의 경우에만 사용 가능하므로, 버튼 클릭 시 로그인 여부를 확인해야 합니다.
비회원(guest)
비회원의 경우 좋아요 기능을 지원하지 않습니다.
좋아요 버튼 클릭 시 로그인 여부를 확인하여, 미로그인(비회원)시 서비스이용불가 안내창 노출 후 로그인 페이지로 현재창 이동해야 합니다.
회원(member)
로그인한 상태에서 좋아요 버튼 클릭 시, 아래 POST /profile/like-products를 호출합니다.
해당 API로 좋아요가 적용된 상품은 마이페이지_쇼핑정보 내 '좋아요' 리스트에 추가됩니다.
▶ 회원이 상품을 좋아한다고 추가/삭제하기 회원이 좋아요한 상품을 목록에 추가하거나 삭제합니다
Last updated