> ## 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.

# 연결 범위

> 연동이 읽고 쓸 수 있는 데이터베이스와 행의 범위를 정리합니다.

연동은 연결한 데이터베이스만 읽고 쓸 수 있습니다. 연결은 데이터베이스 하나씩 합니다. 스페이스 전체를 한 번에 연결할 수는 없습니다.

## 데이터베이스 연결하기

두 곳에서 연결할 수 있습니다.

* 연동 상세: `연결된 데이터베이스` → `데이터베이스 추가`
* 데이터베이스 메뉴: `⋯` → `API 연동`

| 작업 | 할 수 있는 사람 |
| - | - |
| 연동 상세 열기: 연동 만들기 · 토큰 · 권한 · 지우기 · 웹훅 | 팀 소유자 |
| 연동 상세의 `데이터베이스 추가` | 팀 소유자. 목록에는 전체 허용 권한이 있는 데이터베이스만 나옵니다. |
| 연동 상세의 `끊기` | 팀 소유자. 데이터베이스 권한이 없어도 됩니다. |
| 데이터베이스 `⋯` 메뉴에서 연결 · 끊기 | 그 데이터베이스에 전체 허용 권한이 있는 팀 소유자와 멤버 |

게스트는 데이터베이스를 연결하거나 끊을 수 없습니다.

## 연결할 수 있는 데이터베이스

스페이스 데이터베이스와 접근 제한 데이터베이스를 연결할 수 있습니다. 다음은 연결할 수 없습니다.

* 개인 데이터베이스
* 앱이 자동으로 만드는 데이터베이스(예: 세션 목록)
* 소유자가 없는 데이터베이스

인라인 데이터베이스는 따로 연결하지 않습니다. 인라인 데이터베이스가 들어 있는 문서가 속한 데이터베이스를 연결하면 함께 보입니다.

## 연결하면 보이는 대상

* 그 데이터베이스의 행
* 행 아래의 하위 문서
* 그 행과 하위 문서 안에 있는 인라인 데이터베이스와 그 행

## 연결해도 보이지 않는 대상

| 대상 | 동작 |
| - | - |
| 권한을 따로 정한 행 | 그 행 · 하위 문서 · 안의 인라인 데이터베이스까지 없는 것으로 처리합니다. 직접 읽으면 404입니다. |
| 본문의 링크된 보기가 가리키는 다른 데이터베이스 | 보기가 있어도 열리지 않습니다. 그 데이터베이스를 따로 연결하세요. |
| 연결하지 않은 데이터베이스를 가리키는 관계 속성 | 데이터 소스의 `properties`에서 빠집니다. 행 값에는 `relation: []`과 `has_more: false`로 남습니다. 그 관계를 쓰는 롤업도 빈 값입니다. |
| 연동이 읽지 못하는 문서 멘션 | ID만 있고 `plain_text`는 `Untitled`입니다. |
| 연동이 읽지 못하는 문서를 가리키는 카드 | 블록에서 `unsupported`(`block_type: "alias"`)입니다. |

관계 필터는 대상 데이터베이스가 보이지 않아도 실제 관계를 기준으로 동작합니다. 롤업 필터와 정렬은 빈 값을 기준으로 동작합니다. 수식과 롤업 값은 연동이 볼 수 있는 행만으로 계산합니다.

## 연결하지 않았을 때의 응답

연결하지 않은 대상과 없는 대상은 구분되지 않습니다. 모두 404 `object_not_found`를 반환합니다.

```json theme={null}
{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find data source with ID: exampleDb001. Make sure the relevant pages and databases are shared with your connection \"주문 동기화\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```

## 연결 끊기

`끊기`를 누르면 그 데이터베이스는 바로 404를 반환합니다. 웹훅도 바로 멈추고, 전송을 기다리던 이벤트도 전송하지 않습니다. 연결이 끊겼음을 알리는 이벤트는 없습니다.

## 휴지통에 있는 데이터베이스

연결한 데이터베이스를 휴지통에 넣어도 연결은 유지됩니다. 끊기 전까지 연동은 다음과 같이 읽습니다.

| 요청 | 응답 |
| - | - |
| 데이터베이스 · 데이터 소스 · 블록 읽기 | 200, `in_trash: true` |
| 그 데이터베이스의 행 · 속성 · 마크다운 읽기 | 200. 행 객체는 `in_trash: true`입니다. |
| 쿼리 · 블록 자식 읽기 | 404 |
| 검색 | 결과에 나오지 않습니다. |
| 행 만들기 · 고치기 | 400 `Can't edit block that is archived...` |

연동 상세에는 `휴지통에 있음`으로 표시되고, 여기서 끊을 수 있습니다.


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