> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/store-front/display/undefined-1.md).

# 전시 카테고리

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

***

## 주요 기능

* **전시 카테고리 목록 조회**
  * 전체 전시 카테고리 정보 또는 특정 브랜드의 전시 카테고리 정보를 조회합니다.
  * 사용 여부가 '사용함'인 카테고리의 정보만을 조회합니다.
  * 상위 카테고리가 하위 카테고리 리스트를 포함하는 계층적인 형태로 데이터를 제공합니다.
  * 전체 전시 카테고리 정보: 전체 전시 카테고리 정보를 조회합니다.
  * 브랜드 전시 카테고리 정보: 브랜드 번호로 조회할 경우 해당 브랜드 상품들이 속해 있는 전시 카테고리 정보를 조회합니다.
* **전시 카테고리 상품 조회**
  * 전시 카테고리 번호로 조회 시 하위 카테고리를 탐색하여 최하위 카테고리의 상품 상세 정보 목록을 조회합니다.
  * 상품 번호로 조회 시 해당 상품의 상세 정보 목록을 조회합니다.
  * 페이지 번호와 페이지 사이즈를 전달하여 페이지 번호, 사이즈에 따라 건수를 조회하며, 전체 개수를 함께 반환합니다.
* **단건 전시 카테고리 정보**
  * 전시 카테고리 번호로 해당 전시 카테고리의 정보를 조회합니다.
  * 계층 구조로 하위 카테고리 정보까지 전달하는 것이 아니라, 전달받은 전시 카테고리 번호의 정보만을 조회합니다.
* **전시 아이콘 목록 조회**
  * 사이트 번호를 기준으로 전시 아이콘 목록을 조회합니다.
  * 사용 여부가 '사용함'인 아이콘 정보만을 조회합니다.

## 프로세스 정의

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FwKNmjFEAtp1ctGFgrAgm%2F183795744.jpg?alt=media&amp;token=53a6af66-d1fb-40f8-b539-95df406f6929" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 전시 아이콘 목록 조회

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

* 전체 전시 카테고리 조회 시: 사용하는 전체 전시 카테고리 조회 후 GNB나 매장 상단 카테고리 메뉴에 노출
* 브랜드 카테고리 조회: 브랜드 매장 진입 시 해당 브랜드 상품들이 속한 카테고리만 조회
  {% endstep %}

{% step %}

### 전시 상품 조회

전시 상품을 조회합니다.

* 판매 기한 내 전시 상태의 판매, 품절 상품만을 노출
* 성인 여부: 회원의 성인 여부를 확인해 19금 상품을 제한하여 노출
  {% endstep %}

{% step %}

### 전시 아이콘 목록 조회 (이미지 매핑)

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

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

## API 기능 목록

<table data-full-width="false"><thead><tr><th width="129.333251953125">API</th><th width="288.888916015625">설명</th><th width="81.2222900390625">Server</th><th width="79.333251953125">메소드</th><th>비고</th></tr></thead><tbody><tr><td>전시 카테고리 목록 조회</td><td>•전체 전시 카테고리 정보 또는 브랜드 전시 카테고리 정보(브랜드 번호를 전달 받는 경우)를 대/중/소/세 계층적으로 조회합니다.</td><td>Display</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=display&#x26;depth=%EC%A0%84%EC%8B%9C%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC&#x26;path=getCategoryList">🔗API 확인하기></a></td></tr><tr><td>전시카테고리 단건 조회</td><td><p>•전시카테고리번호를 전달 받아 해당 전시 카테고리 정보만을 조회합니다. </p><p>•계층적이지 않은 해당 카테고리 정보만을 조회합니다.</p></td><td>Display</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=display&#x26;depth=%EC%A0%84%EC%8B%9C%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC&#x26;path=getDisplayCategory">🔗API 확인하기></a></td></tr><tr><td>전시상품 조회</td><td>•전시 카테고리번호 전달 시 전시 카테고리 상품 상세 정보 목록을 조회합니다. <br>•상품번호 전달 시 해당 상품의 상세 정보 목록을 조회합니다. <br>•페이지번호, 페이지사이즈 전달 시 전체 개수를 함께 조회합니다.</td><td>Display</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=display&#x26;depth=%EC%A0%84%EC%8B%9C%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC&#x26;path=getGoodsList">🔗API 확인하기></a></td></tr><tr><td>전시 아이콘 목록 조회</td><td>•사이트번호 기준으로 전시 아이콘 정보 목록을 조회합니다.</td><td>Display</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=display&#x26;depth=%EC%A0%84%EC%8B%9C%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC&#x26;path=getIconList">🔗API 확인하기></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="130.6666259765625">명칭</th><th>설명</th></tr></thead><tbody><tr><td>전시 카테고리</td><td><p>전시 계층 구조 상 사이트, 몰 하위에 특정 분류에 따라 관리 및 전시되는 주체를 </p><p>의미합니다. 대/중/소/세 순서로 구성되며 상위 카테고리 번호를 이용해 계층적으로 연결됩니다.</p></td></tr><tr><td>Depth</td><td>전시 카테고리 계층 깊이 단위입니다. 대/중/소/세를 1~4까지의 숫자로 표현합니다.<br>Ex) 대카테고리의 경우: 1, 세카테고리의 경우: 4</td></tr><tr><td>최하위 여부</td><td>하위 카테고리가 존재하지 않고 전시 상품을 갖는 전시 카테고리 구분 값입니다. <br>최하위 카테고리 일 경우 해당 카테고리에 전시 상품을 추가할 수 있습니다. <br>최하위 카테고리가 아닐 경우 하위 카테고리를 갖습니다.</td></tr></tbody></table>

## 기타 참고사항

* 아이콘 정책
  * 아이콘은 BEST, NEW, BO 설정 아이콘 순으로 노출됩니다.
  * 화면에서 나오는 아이콘은 최대 3개로 제한됩니다.
  * 아이콘의 노출범위는 상품, 게시판, 이벤트, 장바구니로 설정할 수 있습니다.
  * BEST : 랭킹데이터 당일 또는 (당일+전일) 기준으로 노출
  * NEW : 상품등록일 14일 기준으로 노출