> 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-api/undefined-1/undefined-2.md).

# 브랜드 목록 및 메인

온라인 커머스에 등록된 브랜드 목록 페이지를 통해 브랜드 콘텐츠를 다양하게 노출할 수 있습니다. 브랜드를 선택하면 해당 브랜드에 대한 정보를 제공하고 해당 브랜드의 제품을 탐색할 수 있는 기능을 제공합니다. 이 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%2FUWXVxfP0qzfyLT8pa3CH%2Fimage-20240416-043004.png?alt=media&amp;token=e5b1caa6-6e35-4fd5-8371-29f5b3ac2c04" alt=""><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%2FzAoxEO70c8dYtnL2fLAd%2Fimage-20240416-043000.png?alt=media&amp;token=bd2476b0-328d-4f5d-b711-5dd097442e06" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

***

## 브랜드 목록 조회하기 <a href="#plus" id="plus"></a>

<div align="center"><figure><img src="https://tech.x2bee.com/download/attachments/266109482/%EC%8A%A4%ED%86%A0%EC%96%B4%20%ED%94%84%EB%A1%A0%ED%8A%B8%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EB%B8%8C%EB%9E%9C%EB%93%9C%EB%AA%A9%EB%A1%9D.drawio.png" alt="" width="563"><figcaption></figcaption></figure></div>

### 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/getShopInfoByShopNo))\
  매장 번호로 매장정보(비정형, 카테고리, 브랜드 매장)와 해당 매장의 코너 정보를 조회합니다.

```
GET /v1/shop/{shopNo} 
```

#### 1-1. 추천 브랜드 코너 <a href="#id-1-1" id="id-1-1"></a>

노출하고 싶은 이미지와 텍스트를 그룹으로 묶어 전시 할 수 있습니다.\
클릭 시 설정한 연결 URL로 이동할 수 있습니다.

#### 1-2. 전체 브랜드 코너 <a href="#id-1-2" id="id-1-2"></a>

최대 24개의 브랜드를 전시 할 수 있습니다.\
클릭 시 설정한 연결 URL로 이동하며, 연결 URL 미입력 시 해당 브랜드 매장으로 이동합니다.

#### 1-3. 베스트 브랜드 코너 <a href="#id-1-3" id="id-1-3"></a>

이미지, 브랜드, 텍스트 그룹 세트 최대 3개의 베스트 브랜드 코너를 전시 할 수 있습니다.\
이미지 배너 클릭 시 설정한 연결 URL로 이동하며, 상품 클릭 시 상품 상세 페이지로 이동합니다.

#### 1-4. 신규 브랜드 코너 <a href="#id-1-4" id="id-1-4"></a>

노출하고 싶은 이미지와 브랜드를 최대 10개 전시 할 수 있습니다.\
클릭 시 설정한 연결 URL로 이동할 수 있습니다.

## 브랜드 메인 조회하기 <a href="#plus" id="plus"></a>

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109482/FO%20API%20%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EB%B8%8C%EB%9E%9C%EB%93%9C%20%EB%A9%94%EC%9D%B8.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/getShopInfoByBrandNo))\
  브랜드 번호로 매장에 대한 정보를 조회합니다.

```
GET /v1/shop/brand/{brandNo} 
```

### 2. 위시리스트 등록/삭제하기 <a href="#id-2" id="id-2"></a>

브랜드 페이지에서 해당 브랜드를 위시리스트로 등록하거나 삭제 할 수 있습니다.

* **위시리스트 등록 (** [🔗API 확인하기 >](https://api.x2bee.com/content?msa=member\&depth=%EC%9C%84%EC%8B%9C%EB%A6%AC%EC%8A%A4%ED%8A%B8\&path=registerWishlist))\
  해당 브랜드를 로그인한 사용자의 위시리스트에 등록합니다

```
POST /v1/front/wishlist   
```

* **위시리스트 삭제 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=member\&depth=%EC%9C%84%EC%8B%9C%EB%A6%AC%EC%8A%A4%ED%8A%B8\&path=deleteWishList))\
  해당 브랜드를 로그인한 사용자의 위시리스트에 삭제합니다

```
DEL /v1/front/wishlist   
```