# Univer Boards API

> Univer Boards 애플리케이션에서 Facade API를 사용하는 방법을 알아봅니다.

- Human documentation: [https://docs.univer.ai/ko-KR/guides/boards/features/core/boards-api](https://docs.univer.ai/ko-KR/guides/boards/features/core/boards-api)

- Agent Markdown: [https://docs.univer.ai/ko-KR/guides/boards/features/core/boards-api.md](https://docs.univer.ai/ko-KR/guides/boards/features/core/boards-api.md)

- Requested language: `ko-KR`

- Content language: `ko-KR`

- Documentation version: `1.0.4`

- Source: [boards/features/core/boards-api.ko-KR.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/boards/features/core/boards-api.ko-KR.mdx)

---

Facade API는 Univer 서비스 및 유닛 모델 위에 애플리케이션용 계층을 제공합니다. Board 만들기, 활성 페이지 읽기, 요소 추가, 컨테이너 업데이트, 스윔레인 관리와 같은 일반적인 Board 작업에 사용하세요.

> [!WARNING: 주의]
> Board 변경 API는 동기식이며 `boolean` 또는 nullable 핸들을 반환합니다. 반환값을 확인하세요.

## Facade 진입점 활성화

Boards는 Web SDK 플러그인으로 배포됩니다. 애플리케이션에서 사용하는 Board 기능의 Facade 진입점을 가져옵니다.

```ts
import { FUniver } from '@univerjs/core/facade'
import '@univerjs-pro/boards/facade'
```

Univer 인스턴스와 필수 플러그인을 등록한 후 API 객체를 만듭니다.

```ts
const univerAPI = FUniver.newAPI(univer)
```

## Board 만들기 및 읽기

`createBoard`를 사용하여 Facade 계층을 통해 Board 유닛을 만듭니다. 하위 수준 설정 코드에서는 `univer.createUnit(UniverInstanceType.UNIVER_BOARD, snapshot)`으로 유닛을 만듭니다.

```ts
const board = univerAPI.createBoard({
  id: 'board-demo',
  name: 'Board Demo',
})

const activeBoard = univerAPI.getActiveBoard()
const sameBoard = univerAPI.getBoard(board.getId())
```

## 핵심 기능 계속 보기

반환된 `FBoard` 객체는 활성 페이지와 해당 콘텐츠의 진입점입니다. 자세한 작업은 다음 가이드를 참고하세요.

* [요소](https://docs.univer.ai/ko-KR/guides/boards/features/core/elements.md)에서는 Board 요소 읽기, 삽입, 연결, 변형, 배치 및 삭제를 설명합니다.
* [컨테이너 및 스윔레인](https://docs.univer.ai/ko-KR/guides/boards/features/core/containers.md)에서는 프레임 그룹, 소속 관계 및 스윔레인 구조를 설명합니다.

## 참고 자료

* [General API](https://docs.univer.ai/ko-KR/guides/boards/features/core/general-api.md)
* [Boards Facade 레퍼런스](https://docs.univer.ai/ko-KR/reference/facade/board.md)
* [Board 데이터 모델](https://docs.univer.ai/ko-KR/guides/boards/model/board-data.md)
* [Board 요소](https://docs.univer.ai/ko-KR/guides/boards/model/board-elements.md)