# 카테고리

상품의 카테고리를 효과적으로 탐색하고, 카테고리 관련 정보를 제공하는 데 사용됩니다. X2BEE BO에 전시 카테고리 메뉴에 등록 된 카테고리 정보와 카테고리에 매핑된 상품들을 전시 할 수 있습니다. 이 API를 통해 사용자는 원하는 카테고리를 선택하고 해당 카테고리 내의 제품 목록 및 정보에 액세스할 수 있습니다.

***

{% columns %}
{% column %}

<p align="center"><strong>PC</strong></p>

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FjWndOxTNapjawZNU7skm%2Fimage-20240416-042519.png?alt=media&#x26;token=e1f54cbb-85ff-46eb-b148-7ddceb474cc4" alt="" width="375"><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<p align="center"><strong>Mobile</strong></p>

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FEUrd1ETGHYnNf9beq5lq%2Fimage-20240416-042627.png?alt=media&#x26;token=8810292e-1046-457f-bfc4-2b42f244a514" alt="" width="176"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

## 카테고리 목록 <a href="#plus" id="plus"></a>

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109414/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC%20%EC%A0%95%EB%B3%B4.drawio.png" alt=""></p>

### 1. 카테고리 목록 조회 <a href="#id-1" id="id-1"></a>

계층 구조로 구성된 전시 카테고리 정보를 제공합니다.

* **전시 카테고리 목록 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=display\&depth=%EC%A0%84%EC%8B%9C%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC\&path=getCategoryList))\
  전체 전시 카테고리 정보 또는 브랜드 전시카테고리 정보를 조회 할 수 있습니다.

```
GET /v1/displayCategory 
```

***

## 카테고리 매장 <a href="#plus" id="plus"></a>

카테고리 목록에서 원하는 카테고리를 클릭하면 연결된 전시 카테고리 매장 페이지로 이동합니다.

연결된 카테고리 매장은 템플릿에 따라 정보와 상품 전시 목록이 다르게 보일 수 있습니다.

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109414/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EC%A0%84%EC%8B%9C%20%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC%20%EC%83%81%ED%92%88%EC%A0%84%EC%8B%9C.drawio.png" alt=""></p>

### 1.카테고리 매장 정보 조회 <a href="#id-1" id="id-1"></a>

해당 카테고리에 등록된 매장의 정보를 호출하여 조회할 수 있습니다.

* **카테고리 매장정보 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=display\&depth=%EC%A0%84%EC%8B%9C%EB%A7%A4%EC%9E%A5/getShopInfoByDispCtgNo))\
  해당 카테고리의 매장 정보를 조회합니다.

```
GET /v1/shop/category/{dispCtgNo} 
```

### 2. 전시 상품 목록 조회 <a href="#id-2" id="id-2"></a>

해당 카테고리에 매핑 된 상품들을 전시 할 수 있습니다.

* **전시상품 조회 (**[🔗API 확인하기 >](https://api-goods.x2bee.com/api/goods/swagger-ui/index.html#/%EC%83%81%ED%92%88%EA%B2%80%EC%83%89/seltSearchProduct))\
  해당 카테고리의 정렬 조건, 필터 조건등을 추가하여 상품의 리스트를 조회합니다.

```
GET /v1/search/product 
```