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

# 데이터 소스 읽기

> 데이터베이스의 속성 정의를 읽습니다.

속성 이름 · ID · 종류와 선택지를 읽습니다. 데이터 소스 ID는 데이터베이스 ID와 같습니다.

**Authorization** `string` *required*

`Bearer <토큰>` 형식입니다. [토큰 자세히 알아보기 →](https://developers.bottari.ai/ko/auth/tokens.md)

**Bottari-Version** `string`

선택 항목입니다. `2026-03-11`만 받습니다. 빼면 현재 버전을 사용하고, 다른 값을 보내면 400을 반환합니다.

**id** `string` *required*

데이터 소스 ID입니다. 데이터베이스 ID를 넣으세요.

**properties** `object`

속성 이름을 키로 한 속성 정의입니다. 각 값에 `id` · `name` · `description` · `type`과 종류별 설정이 있습니다.

다음 속성은 빠집니다.

* 세션 · 연결된 페이지 · PR 속성
* 연결하지 않은 데이터베이스를 가리키는 관계 속성과 그 관계를 쓰는 롤업 속성

이 관계와 롤업은 행 응답에 빈 값으로 나옵니다. `filter_properties` · 필터 · 정렬에 사용할 수 있습니다. 관계 필터는 응답에 보이지 않아도 실제 연결을 기준으로 동작합니다.

**parent** `object`

`{ "type": "database_id", "database_id": "..." }`입니다.

**database\_parent** `object`

그 데이터베이스의 부모입니다.

**title** `object[]`

이름입니다.

**in\_trash** `boolean`

데이터베이스나 그 위의 문서가 휴지통에 있으면 `true`입니다.

## 속성 정의

| 종류 | 설정 |
| - | - |
| `number` | `format` |
| `select` · `multi_select` | `options`: `id` · `name` · `color` · `description` |
| `status` | `options` · `default_option` · `groups` |
| `unique_id` | `prefix` |
| `formula` | `expression`. 속성은 이름으로 나옵니다. 예: `prop("메모")`. 연동이 읽지 못하는 데이터베이스의 속성은 ID로 나옵니다. |
| `relation` | `database_id` · `data_source_id` · `limit` · `type`(`single_property` 또는 `dual_property`) |
| `rollup` | `rollup_property_name` · `relation_property_name` · `rollup_property_id` · `relation_property_id` · `function` |

## 오류

| 상태 | `code` | 원인 |
| - | - | - |
| 404 | `object_not_found` | 없거나 연결하지 않은 데이터베이스입니다. |

공통 오류는 [공통 규칙](https://developers.bottari.ai/ko/api-reference/overview.md#오류)에서 확인할 수 있습니다.

```bash curl theme={null}
curl https://api.bottari.ai/v1/data_sources/exampleDb001 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"
```

```json 200 theme={null}
{
  "object": "data_source",
  "id": "exampleDb001",
  "created_time": "2026-01-10T01:00:00.000Z",
  "last_edited_time": "2026-01-15T03:10:00.000Z",
  "created_by": {
    "object": "user",
    "id": "11111111-1111-4111-8111-111111111111"
  },
  "last_edited_by": {
    "object": "user",
    "id": "11111111-1111-4111-8111-111111111111"
  },
  "in_trash": false,
  "properties": {
    "이름": {
      "id": "title",
      "name": "이름",
      "description": null,
      "type": "title",
      "title": {}
    },
    "담당 팀": {
      "id": "exampleFld01",
      "name": "담당 팀",
      "description": null,
      "type": "select",
      "select": {
        "options": [
          {
            "id": "exampleOpt01",
            "name": "운영",
            "color": "blue",
            "description": null
          }
        ]
      }
    }
  },
  "parent": {
    "type": "database_id",
    "database_id": "exampleDb001"
  },
  "database_parent": {
    "type": "workspace",
    "workspace": true
  },
  "is_inline": false,
  "database_type": null,
  "title": [
    {
      "type": "text",
      "text": {
        "content": "주문",
        "link": null
      },
      "annotations": {
        "bold": false,
        "italic": false,
        "strikethrough": false,
        "underline": false,
        "code": false,
        "color": "default"
      },
      "plain_text": "주문",
      "href": null
    }
  ],
  "description": [],
  "icon": null,
  "cover": null,
  "url": "https://app.bottari.ai/t/exampleTeam1/db/exampleDb001",
  "public_url": null,
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```


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