> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bottari.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bottari API

> 외부 서버에서 API 토큰으로 Bottari 데이터베이스를 읽고 씁니다.

![Bottari](https://mintcdn.com/bottari/Mr8MNK_X8Zeo63gl/images/tari.png?fit=max\&auto=format\&n=Mr8MNK_X8Zeo63gl\&q=85\&s=bd9210113eae40ada7410f43e20256cb)

Bottari API는 외부 서버가 토큰으로 Bottari 데이터베이스를 읽고 쓰는 API입니다.

> [card] [시작하기](https://developers.bottari.ai/ko/quickstart.md)
>
> 연동을 만들고 첫 요청을 보냅니다.

> [card] [외부 데이터 가져오기](https://developers.bottari.ai/ko/import/external-data.md)
>
> 파일과 데이터베이스를 Bottari로 가져옵니다.

> [card] [웹훅](https://developers.bottari.ai/ko/webhooks/subscribe.md)
>
> 연결한 데이터베이스가 바뀌면 알림을 받습니다.

> [card] [API 레퍼런스](https://developers.bottari.ai/ko/api-reference/overview.md)
>
> 엔드포인트마다 예제와 오류를 확인합니다.

```bash theme={null}
curl -X POST https://api.bottari.ai/v1/data_sources/exampleDb001/query \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## 할 수 있는 일

| 작업 | 엔드포인트 | 필요한 권한 |
| - | - | - |
| 데이터베이스와 행 읽기, 제목으로 찾기 | `/v1/search` · `/v1/databases` · `/v1/data_sources` · `/v1/pages` | `내용 읽기` |
| 본문을 블록이나 마크다운으로 읽기 | `/v1/blocks` · `/v1/pages/{id}/markdown` | `내용 읽기` |
| 사용자 읽기 | `/v1/users` | `사용자 정보` |
| 댓글 읽기 | `/v1/comments` | `댓글 읽기` |
| 행 만들기 | `POST /v1/pages` | `내용 추가` |
| 행 고치기, 휴지통, 되살리기, 보관, 잠금 | `PATCH /v1/pages/{id}` | `내용 수정` |
| 변경 알림 받기 | [웹훅](https://developers.bottari.ai/ko/webhooks/subscribe.md) | `내용 읽기`, 댓글 이벤트는 `댓글 읽기` |

## 제공하지 않는 기능

다음 기능은 API에 없습니다. [없는 엔드포인트 자세히 알아보기 →](https://developers.bottari.ai/ko/api-reference/overview.md#없는-엔드포인트)

* 본문 블록 쓰기: 블록은 읽기만 할 수 있습니다.
* 댓글 쓰기: 댓글은 읽기만 할 수 있습니다.
* 파일 업로드: 파일 속성에는 바깥 주소만 새로 넣을 수 있습니다.
* 데이터베이스 만들기와 구조 변경: `select`와 `multi_select` 값을 새 이름으로 쓰면 그 선택지만 만들어집니다.
* 행 아래에 하위 문서 만들기: 하위 문서는 읽기와 제목 · 휴지통 · 보관 · 잠금 · 아이콘 · 표지 변경만 할 수 있습니다.

## 주요 용어

* '연동': 토큰과 권한을 가진 외부 서버용 계정입니다. 팀 설정에서 만듭니다.
* '연결': 연동이 읽고 쓸 데이터베이스를 하나씩 지정하는 일입니다. 연결하지 않은 데이터베이스는 없는 것으로 처리합니다.
* '행': 데이터베이스의 항목입니다. API 객체 이름은 `page`입니다.
* '데이터 소스': Bottari 데이터베이스에는 데이터 소스가 하나뿐입니다. 데이터베이스 ID와 데이터 소스 ID가 같습니다.
* '하위 문서': 행 아래에 있는 문서입니다. API에서는 `parent`가 `page_id`인 `page`이고, 속성은 제목 하나뿐입니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.