> 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="/files/9Pre6pzB5aYFwJAJf3gm" alt="" width="375"><figcaption></figcaption></figure> <figure><img src="/files/nTVHWRStrVdsc7wBRiEX" 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개 상품으로 묶어 전시 할 수 있습니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api-guide/store-front-api/undefined-1/undefined.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.