전시 카테고리

Owned by X2BEE 관리자, created
Last updated: 2023-12-01 by 정현 도
3 min read

전체 또는 브랜드 번호(brandNo)를 기준으로, Front 화면에 전시 카테고리를 구성하기 위한 정보를 제공합니다. 대/중/소/세 카테고리 형태로 Depth에 따라 계층적으로 관리되며, 전시 카테고리의 기본 정보 및 계층 구조를 제공합니다. 이 API는 GNB 카테고리 영역 및 카테고리 매장에 노출되며, 헤더 영역에도 노출될 수 있습니다.

주요 기능

  • 전시 카테고리 목록 조회

    • 전체 전시 카테고리 정보 또는 특정 브랜드의 전시 카테고리 정보를 조회합니다.

    • 사용 여부가 '사용함'인 카테고리의 정보만을 조회합니다.

    • 상위 카테고리가 하위 카테고리 리스트를 포함하는 계층적인 형태로 데이터를 제공합니다.

    • 전체 전시 카테고리 정보: 전체 전시 카테고리 정보를 조회합니다.

    • 브랜드 전시 카테고리 정보: 브랜드 번호로 조회할 경우 해당 브랜드 상품들이 속해 있는 전시 카테고리 정보를 조회합니다.

  • 전시 카테고리 상품 조회

    • 전시 카테고리 번호로 조회 시 하위 카테고리를 탐색하여 최하위 카테고리의 상품 상세 정보 목록을 조회합니다.

    • 상품 번호로 조회 시 해당 상품의 상세 정보 목록을 조회합니다.

    • 페이지 번호와 페이지 사이즈를 전달하여 페이지 번호, 사이즈에 따라 건수를 조회하며, 전체 개수를 함께 반환합니다.

  • 단건 전시 카테고리 정보

    • 전시 카테고리 번호로 해당 전시 카테고리의 정보를 조회합니다.

    • 계층 구조로 하위 카테고리 정보까지 전달하는 것이 아니라, 전달받은 전시 카테고리 번호의 정보만을 조회합니다.

  • 전시 아이콘 목록 조회

    • 사이트 번호를 기준으로 전시 아이콘 목록을 조회합니다.

    • 사용 여부가 '사용함'인 아이콘 정보만을 조회합니다.

 

프로세스 정의

 

번호

구분

설명

번호

구분

설명

1

전시 아이콘 목록 조회

전시 카테고리를 조회합니다.

  • 전체 전시 카테고리 조회 시: 사용하는 전체 전시 카테고리 조회 후 GNB나 매장 상단 카테고리 메뉴에 노출

  • 브랜드 카테고리 조회:  브랜드 매장 진입 시 해당 브랜드 상품들이 속한 카테고리만 조회

2

전시 상품 조회

전시 상품을 조회합니다.

  • 판매 기한 내 전시 상태의 판매, 품절 상품만을 노출

  • 성인 여부: 회원의 성인 여부를 확인해 19금 상품을 제한하여 노출

3

전시 아이콘 목록 조회

전시 아이콘 목록을 조회합니다.

  • 전시 아이콘 이미지 정보를 화면 store에 key(아이콘번호), value(아이콘이미지정보) 값으로 저장해 상품에 있는 아이콘 번호와 key매칭하여 이미지를 가져옵니다.

 

API 기능 목록

API

설명

Server

메소드

비고

API

설명

Server

메소드

비고

 전시 카테고리 목록 조회

•전체 전시 카테고리 정보 또는 브랜드 전시 카테고리 정보(브랜드 번호를 전달 받는 경우)를 대/중/소/세 계층적으로 조회합니다.

Display

GET

🔗API 확인하기>

 전시카테고리 단건 조회

•전시카테고리번호를 전달 받아 해당 전시 카테고리 정보만을 조회합니다.

•계층적이지 않은 해당 카테고리 정보만을 조회합니다,

Display

GET

🔗API 확인하기>

 전시상품 조회

•전시 카테고리번호 전달 시 전시 카테고리 상품 상세 정보 목록을 조회합니다.

•상품번호 전달 시 해당 상품의 상세 정보 목록을 조회합니다.

•페이지번호, 페이지사이즈 전달 시 전체 개수를 함께 조회합니다.

Display

GET

🔗API 확인하기>

 전시 아이콘 목록 조회

•사이트번호 기준으로 전시 아이콘 정보 목록을 조회합니다.

Display

GET

🔗API 확인하기>

 

용어 정의

명칭

설명

비고

명칭

설명

비고

전시 카테고리

전시 계층 구조 상 사이트, 몰 하위에 특정 분류에 따라 관리 및 전시되는 주체를 의미합니다.

대/중/소/세 순서로 구성되며 상위 카테고리 번호를 이용해 계층적으로 연결됩니다.

 

Depth

전시 카테고리 계층 깊이 단위입니다.

대/중/소/세를 1~4까지의 숫자로 표현합니다.
Ex) 대카테고리의 경우: 1, 세카테고리의 경우: 4

 

최하위 여부

하위 카테고리가 존재하지 않고 전시 상품을 갖는 전시 카테고리 구분 값입니다.

최하위 카테고리 일 경우 해당 카테고리에 전시 상품을 추가할 수 있습니다.

최하위 카테고리가 아닐 경우 하위 카테고리를 갖습니다.

 

기타 참고사항

  • 아이콘 정책

    • 아이콘은 BEST, NEW, BO설정 아이콘 순으로 노출됩니다.

    • 화면에서 나오는 아이콘은 최대 3개로 제한됩니다.

    • 아이콘의 노출범위는 상품, 게시판, 이벤트, 장바구니로 설정할 수 있습니다.

    • BEST : 랭킹데이터 당일 또는 (당일+ 전일) 기준으로 노출

    • NEW : 상품등록일 14일 기준으로 노출