> ## 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-адреса, автентифікація, ідентифікатори та поширені шаблони запитів.

Цей розділ допоможе швидко й безпечно розпочати роботу з 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'
```

Можна використовувати один із варіантів:

* **Персональний токен доступу**: найкраще підходить для скриптів, внутрішніх інструментів та інтеграцій на боці сервера. Див. розділ [Токен доступу](/uk/api-doc/token).
* **Токен доступу OAuth**: найкраще підходить для багатокористувацьких інтеграцій, у яких кінцеві користувачі надають доступ. Див. розділ [Застосунок OAuth](/uk/api-doc/oauth).

## Ідентифікатори (spaceId / baseId / tableId / viewId / fieldId / recordId)

Для більшості кінцевих точок потрібні ідентифікатори на кшталт `tbl...`, `rec...`. Див. розділ [Як знайти ідентифікатори](/uk/api-doc/get-id).

## Області дозволів і права доступу

Права доступу як Персональних токенів доступу, так і токенів OAuth обмежено заданими областями дозволів. Якщо ви отримуєте помилку 403, це зазвичай означає, що токен не має необхідної області дозволів.

* Див. розділ [Коди помилок](/uk/api-doc/error-code)
* Довідка щодо областей дозволів OAuth: [Застосунок OAuth](/uk/api-doc/oauth#available-scopes)

## Пагінація (take / skip)

Багато кінцевих точок, що повертають списки, підтримують такі параметри:

* `take`: кількість елементів, які потрібно повернути (деякі кінцеві точки обмежують це значення; наприклад, для Записів — не більше 100 на запит, тому переходьте між сторінками за допомогою `skip`)
* `skip`: кількість елементів, які потрібно пропустити

## Ключі Полів і формат комірок

Деякі API дають змогу керувати представленням Полів Запису:

* `fieldKeyType`: `name` (за замовчуванням) / `id` / `dbFieldName`
* `cellFormat`: `json` (за замовчуванням) / `text`

Структури значень Полів Запису описано в розділі [Інтерфейс Полів Запису](/uk/api-doc/record/interface).

## Наступні кроки

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