Цей розділ допоможе швидко й безпечно розпочати роботу з API Teable.
Базова URL-адреса
- Teable Cloud:
https://app.teable.ai
- Самостійне розгортання: використовуйте власний домен (наприклад,
https://teable.example.com)
Усі шляхи API в цій документації вказано відносно базової URL-адреси й починаються з /api.
Автентифікація
API Teable використовують Bearer-токени:
Можна використовувати один із варіантів:
- Персональний токен доступу: найкраще підходить для скриптів, внутрішніх інструментів та інтеграцій на боці сервера. Див. розділ Токен доступу.
- Токен доступу OAuth: найкраще підходить для багатокористувацьких інтеграцій, у яких кінцеві користувачі надають доступ. Див. розділ Застосунок OAuth.
Ідентифікатори (spaceId / baseId / tableId / viewId / fieldId / recordId)
Для більшості кінцевих точок потрібні ідентифікатори на кшталт tbl..., rec.... Див. розділ Як знайти ідентифікатори.
Області дозволів і права доступу
Права доступу як Персональних токенів доступу, так і токенів OAuth обмежено заданими областями дозволів. Якщо ви отримуєте помилку 403, це зазвичай означає, що токен не має необхідної області дозволів.
Пагінація (take / skip)
Багато кінцевих точок, що повертають списки, підтримують такі параметри:
take: кількість елементів, які потрібно повернути (деякі кінцеві точки обмежують це значення; наприклад, для Записів — не більше 100 на запит, тому переходьте між сторінками за допомогою skip)skip: кількість елементів, які потрібно пропустити
Ключі Полів і формат комірок
Деякі API дають змогу керувати представленням Полів Запису:
fieldKeyType: name (за замовчуванням) / id / dbFieldNamecellFormat: json (за замовчуванням) / text
Структури значень Полів Запису описано в розділі Інтерфейс Полів Запису.
Наступні кроки
Останнє оновлення 4 вересня 2026 р.
