# API 개요

> API 검색, 패키지 설정, Univer Office SDK 시작하기.

- Human documentation: [https://docs.univer.ai/ko-KR/reference](https://docs.univer.ai/ko-KR/reference)

- Agent Markdown: [https://docs.univer.ai/ko-KR/reference.md](https://docs.univer.ai/ko-KR/reference.md)

- Requested language: `ko-KR`

- Content language: `ko-KR`

- Documentation version: `1.0.4`

- Source: [index.ko-KR.mdx](https://github.com/dream-num/documentation/blob/dev/content/reference/index.ko-KR.mdx)

---

Facade API로 애플리케이션에서 Office 콘텐츠를 읽고 수정할 수 있습니다. 제품별 색인에서 API를 찾거나 아래의 초기화 및 플러그인 설정부터 시작하세요.

## API 사용해 보기

먼저 [설치 및 기본 사용법](https://docs.univer.ai/ko-KR/guides/sheets/getting-started/installation.md)을 완료하세요. Sheets 편집기를 초기화하고 `createUniver`가 반환하는 `univerAPI`를 가져온 다음, 아래 코드로 A1 셀에 값을 쓸 수 있습니다.

```ts
const workbook = univerAPI.getActiveWorkbook()
const worksheet = workbook?.getActiveSheet()
worksheet?.getRange('A1').setValue('Hello, Univer!')
```

`univerAPI`는 `FUniver` 인스턴스입니다. Sheets에서는 통합 문서에서 워크시트로, 다시 셀 범위로 접근합니다. 플러그인 모드 초기화와 기능별 Facade 가져오기는 [Facade API 기초](https://docs.univer.ai/ko-KR/guides/sheets/getting-started/facade.md)를 참고하세요.

## 용도별 API 찾기

| 용도                    | 참조 문서                                                                                                                   |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| 인스턴스, 수명 주기, 공통 작업    | [FUniver](https://docs.univer.ai/ko-KR/reference/facade/univer.md)                                                                                     |
| 통합 문서, 워크시트, 셀        | [FWorkbook](https://docs.univer.ai/ko-KR/reference/facade/workbook.md) · [FWorksheet](https://docs.univer.ai/ko-KR/reference/facade/worksheet.md) · [FRange](https://docs.univer.ai/ko-KR/reference/facade/range.md) |
| 문서와 텍스트               | [FDocument](https://docs.univer.ai/ko-KR/reference/facade/document.md)                                                                                 |
| 프레젠테이션                | [Slides](https://docs.univer.ai/ko-KR/reference/facade/presentation.md)                                                                                |
| 화이트보드                 | [Boards](https://docs.univer.ai/ko-KR/reference/facade/board.md)                                                                                       |
| 데이터베이스                | [Bases](https://docs.univer.ai/ko-KR/reference/facade/base.md)                                                                                         |
| PDF 콘텐츠               | [PDF](https://docs.univer.ai/ko-KR/reference/facade/pdf.md)                                                                                            |
| 이벤트                   | [Events](https://docs.univer.ai/ko-KR/reference/facade/events.md)                                                                                      |
| 공동 편집                 | [Collaboration](https://docs.univer.ai/ko-KR/reference/facade/collaboration.md)                                                                        |
| 댓글                    | [Comments](https://docs.univer.ai/ko-KR/reference/facade/thread-comment.md)                                                                            |
| 셀 값, 범위, 스타일 및 제품 스냅샷 | [데이터 타입](https://docs.univer.ai/ko-KR/reference/types.md)                                                                                              |
| 콘텐츠 서식 및 초기화 상수       | [공통 열거형](https://docs.univer.ai/ko-KR/reference/enums.md) · [Facade 열거형 목록](https://docs.univer.ai/ko-KR/reference/facade/enums.md)                                                   |

## 초기화 및 설정

Univer는 *프리셋 모드*와 *플러그인 모드*의 두 가지 통합 방식을 제공합니다. 프리셋 모드는 미리 구성된 플러그인 묶음으로 설정을 간소화하여 쉽게 시작할 수 있습니다. **심층적인 커스터마이징이나 확장**이 필요하다면 플러그인을 개별적으로 조합하고 설정할 수 있는 플러그인 모드를 권장합니다.

각 플러그인의 설정은 사이드바의 **Packages → Plugins**에서 확인하세요. [createUniver](https://docs.univer.ai/ko-KR/reference/methods/create-univer.md)와 **Presets**는 미리 구성된 플러그인 묶음을 간편하게 불러오는 선택지로 사용할 수 있습니다.

## 서버 및 AI 통합

백엔드 공동 편집과 파일 변환은 [Server SDK](https://docs.univer.ai/ko-KR/server.md)에서, CLI 워크플로와 AI Agent 콘텐츠 작업은 [AI SDK](https://docs.univer.ai/ko-KR/ai.md)에서 시작하세요.