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

# Обзор API

> Всё необходимое для начала работы с API Teable: базовый URL, аутентификация, ID и распространённые шаблоны запросов.

Этот раздел поможет быстро и безопасно начать работу с API Teable.

## Базовый URL

* **Teable Cloud**: `https://app.teable.ai`
* **Самостоятельное размещение**: используйте собственный домен (например, `https://teable.example.com`)

Все пути API в этой документации являются относительными относительно базового URL и начинаются с `/api`.

## Аутентификация

API Teable используют **Bearer-токены**:

```bash theme={null}
curl -H 'Authorization: Bearer __token__' \
  'https://app.teable.ai/api/table/__tableId__/record'
```

Можно использовать один из следующих вариантов:

* **Персональный токен доступа**: оптимален для скриптов, внутренних инструментов и серверных интеграций. См. [токен доступа](/ru/api-doc/token).
* **Токен доступа OAuth**: оптимален для мультитенантных интеграций, в которых конечные пользователи предоставляют доступ. См. [OAuth-приложение](/ru/api-doc/oauth).

## ID (spaceId / baseId / tableId / viewId / fieldId / recordId)

Для большинства конечных точек требуются ID, такие как `tbl...`, `rec...`. См. [Получение ID](/ru/api-doc/get-id).

## Области действия и разрешения

Как персональные токены доступа, так и токены OAuth ограничены разрешениями. Если вы получаете ошибку 403, обычно это означает, что у токена отсутствует необходимая область действия.

* См. [Коды ошибок](/ru/api-doc/error-code)
* Справочник областей действия OAuth: [OAuth-приложение](/ru/api-doc/oauth#available-scopes)

## Разбиение на страницы (take / skip)

Многие конечные точки списков поддерживают:

* `take`: количество возвращаемых элементов (для некоторых конечных точек действует ограничение; например, максимум 100 Записей на запрос, поэтому используйте `skip` для разбиения на страницы)
* `skip`: количество пропускаемых элементов

## Ключи Полей и формат ячеек

Некоторые API позволяют управлять представлением Полей Записи:

* `fieldKeyType`: `name` (по умолчанию) / `id` / `dbFieldName`
* `cellFormat`: `json` (по умолчанию) / `text`

Структуры значений Полей Записи см. в разделе [Интерфейс Поля Записи](/ru/api-doc/record/interface).

## Что дальше

* **Нужно только получить данные**: [Получение Записей](/ru/api-doc/record/get)
* **Создание, обновление или удаление Записей**: [Создание Записей](/ru/api-doc/record/create), [Обновление Записи](/ru/api-doc/record/update), [Удаление Записей](/ru/api-doc/record/delete)
* **Загрузка вложений**: [Загрузка вложения](/ru/api-doc/record/upload-attachment)
* **Полный список конечных точек**: используйте левую навигацию в разделе **Справочник API**