> 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.md).

# 메인 페이지

사이트나 애플리케이션의 첫 화면이자 핵심 페이지로, 상품, 콘텐츠, 프로모션 등과 같은 정보를 제공할 수 있습니다. 메인 페이지에서 다양한 정보를 효과적으로 제공하기 위해 사용되는 API를 설명합니다.

***

**PC/Mobile**

<div><figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FjLN2o8geqVuqQoWfEAeZ%2Fmain.png?alt=media&amp;token=4f962b5d-69c4-4d25-8614-182a127b3173" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FUXTRQLlKsQCEypUl9MBi%2Fimage-20240416-040845.png?alt=media&amp;token=2e1e9b8d-6f38-4d64-b78c-483014c2461e" alt="" width="118"><figcaption></figcaption></figure></div>

***

## 헤더 <a href="#plus" id="plus"></a>

고객의 쇼핑몰 상품을 구매하는 과정에서 장바구니 수량 정보 표기를 제공하고 있습니다.

상품 상세 페이지에서 스크롤 진행 시 장바구니 수량 정보에서 위시리스트 등록/삭제 버튼이 활성화 됩니다.

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109322/%EC%83%81%ED%92%88%EC%83%81%EC%84%B8%20fo-1.drawio.png" alt=""></p>

### 1. 장바구니 총 수량 표기 <a href="#id-1" id="id-1"></a>

쇼핑몰의 사이트의 주요 페이지 헤드에 장바구니 수량 정보를 표기합니다.

* **장바구니 총 수량 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=order\&depth=%EC%9E%A5%EB%B0%94%EA%B5%AC%EB%8B%88\&path=getBasketTotalCount))\
  쇼핑백에 담겨있는 상품들의 개수를 조회합니다.
  * 회원 : 회원번호로 조회
  * 비회원: 세션번호로 조회

```
GET /v1/basket/totBsketCnt  
```

***

## 사이트 메인 <a href="#plus" id="plus"></a>

<p align="center"><img src="https://tech.x2bee.com/download/attachments/266109322/FO%20API%ED%99%9C%EC%9A%A9%ED%95%98%EA%B8%B0-%EB%A9%94%EC%9D%B8%20%EC%A1%B0%ED%9A%8C%EC%98%81%EC%97%AD.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/getShopInfoByShopNo))\
  매장 번호로 매장정보(비정형, 카테고리, 브랜드 매장)를 조회합니다.

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

### 2. 구좌 정보 조회 <a href="#id-2" id="id-2"></a>

메인 화면에서 기획전, 브랜드, 이벤트, 랭킹존 화면을 조회 할 수 있습니다.\
해당 정보는 매장 정보에 따라 구좌 정보를 조회합니다.

* **구좌 정보 조회 (**[🔗API 확인하기 >](https://api.x2bee.com/content?msa=display\&depth=%EC%A0%84%EC%8B%9C%EB%A7%A4%EC%9E%A5/getCornerInfoByAdutId))\
  구좌 ID, 전시매체코드로 해당 구좌의 코너와 컨텐츠 정보를 조회합니다.

```
GET /v1/shop/account/{adutId} 
```

***

## 전시 코너 <a href="#plus" id="plus"></a>

메인 페이지에 추천 상품 및 콘텐츠 등과 같이 마케팅이나 상품 전시 목적에 따라 상품, 콘텐츠 등을 매핑하여 전시하는 영역을 전시 코너로 분류합니다.

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

### 1. 매장 정보 조회 <a href="#id-1.-.1" id="id-1.-.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}
```

{% hint style="info" %}
아래는 X2BEE 스토어 프론트 기본으로 설정된 템플릿으로 다음과 같이 코너 유형을 설명하기 위해 예시안으로 구성되어 있습니다
{% endhint %}

#### 1-1. 스와이프 배너 <a href="#id-1-1" id="id-1-1"></a>

노출하고 싶은 이미지와 텍스트를 그룹으로 묶어 전시 할 수 있습니다.

#### 1-2. 추천 카테고리 아이콘 <a href="#id-1-2" id="id-1-2"></a>

추천하고 싶은 카테고리를 최대 9개의 이미지와 텍스트를 그룹으로 묶어 전시 할 수 있습니다.

#### 1-3. 추천 기획전 배너 <a href="#id-1-3" id="id-1-3"></a>

추천하고 싶은 최대 10개의 기획전을 전시 할 수 있습니다.

#### 1-4. 이미지 배너 <a href="#id-1-4" id="id-1-4"></a>

노출하고 싶은 직사각형 이미지 배너를 최대 5개 전시 할 수 있습니다.

#### 1-5. 추천 브랜드 이미지 배너 <a href="#id-1-5" id="id-1-5"></a>

추천하고 싶은 정사각형 이미지를 최대 20개 전시 할 수 있습니다.

#### 1-6. 추천 상품 <a href="#id-1-6" id="id-1-6"></a>

메인 페이지에 추천하고 싶은 상품을 한 그룹당 최대 10개 상품으로 묶어 전시 할 수 있습니다.