> For the complete documentation index, see [llms.txt](https://workspace-help.nhn-commerce.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://workspace-help.nhn-commerce.com/aurora-guide/api-1/common/header.md).

# 공통 상단

헤더 (Header, 쇼핑몰 공통 상단) 영역

<figure><img src="/files/DHp9dfDQooCikuGzpIFS" alt=""><figcaption></figcaption></figure>

상단 바 영역에서 API를 호출하여 화면을 구성해야 하는 요소는 아래 3가지 입니다.

* ⓐ 로고 배너
* ⓑ 장바구니 개수
* ⓒ 전체 카테고리 *<mark style="background-color:orange;">PC</mark>*
* ⓓ MY메뉴 > 1:1문의 버튼(PC)

#### ■ ⓐ 로고 배너

배너 영역 문서에서 소개하는 API 입니다.\
해당 배너 리스트 데이터에 쇼핑몰 로고(Logo)가 포함되어 있습니다.\
로고의 경우 화면이 바뀌어도 대부분의 스킨에서 고정된 자리에 위치해 있기 때문에, 사실상 모든 화면에서 지속적으로 사용되는 API 입니다.

* [배너영역 ](https://workspace-help.nhn-commerce.com/undefined-1/api-1/undefined-1/undefined)

#### ■ ⓑ 장바구니 개수

장바구니 기능은  쇼핑몰 회원 여부와 상관없이 제공합니다.\
단, 회원인 경우에만 API를 호출하여 비회원인 경우 API 호출이 아닌 localStorage에 자체적으로 저장합니다.

* 회원 (member)

> [**GET /cart**](https://docs.shopby.co.kr/?url.primaryName=order/#/Cart/get-cart)
>
> ► 장바구니 개수 조회하기 \
> 로그인 회원의 장바구니 개수를 조회합니다.&#x20;

* 비회원(guest)
  * 비회원의 경우에도 장바구니 버튼을 제공합니다. 단, API 호출이 아닌 localStorage 내 비회원 장바구니 데이터를 자체적으로 관리해야 합니다.

#### ■ ⓒ 전체 카테고리 *<mark style="background-color:orange;">PC</mark>*

> [**GET /categories**](https://docs.shopby.co.kr/?url.primaryName=display/#/Category/get-categories-by-keyword)
>
> ►전체 카테고리 조회하기\
> 쇼핑몰의 카테고리를 조회합니다.&#x20;

쇼핑몰 화면에서 카테고리란, 화면이 바뀌어도 대부분의 경우 화면에 상시 노출되는 요소입니다.

아래 2가지 형태의 카테고리 데이터를 제공합니다.

* flatCategories : 모든 카테고리를 하나의 배열에 쭉 나열한 형태
* multiLevelCategories : 계층을 가지는 카테고리 형태 (최대 5depth)

오로라 개별형 기본 스킨에서는 2depth까지 리스팅되어 출력되며,\
카테고리 상품 리스트에서는 5depth까지 표기됩니다.&#x20;

```
shop by basic/pro: 상품> 상품 분류관리> 전시 카테고리 관리
shop by premium: 전시관리 > 전시 카테고리 관리
```

#### ■ ⓓ MY메뉴 > 1:1문의 버튼(PC)

MY 버튼 hover 시 노출되는 메뉴중 1:1문의 메뉴는 어드민에서 사용설정을 통해 노출이 결정됩니다.